Содержание страницы

Объекты bytearray¶Byte Array Objects

type PyByteArrayObject¶: Этот подтип PyObject представляет объект bytearray Python.

PyTypeObject PyByteArray_Type¶: Часть Stable ABI.
Этот экземпляр PyTypeObject представляет тип bytearray в Python; он является тем же объектом, что и bytearray в слое Python.

Макросы проверки типа¶Type check macros

int PyByteArray_Check(PyObject *o)¶: Возвращает true, если объект o является объектом bytearray или экземпляром подтипа типа bytearray. Эта функция всегда завершается успешно.

int PyByteArray_CheckExact(PyObject *o)¶: Возвращает true, если объект o является объектом bytearray, но не экземпляром подтипа типа bytearray. Эта функция всегда завершается успешно.

PyObject *PyByteArray_FromObject(PyObject *o)¶

Возвращаемое значение: новая ссылка. Часть Stable ABI.

Возвращает новый объект bytearray из любого объекта, o, который реализует протокол буфера.

При ошибке возвращает NULL с установленным исключением.

PyObject *PyByteArray_FromStringAndSize(const char *string, Py_ssize_t len)¶

Возвращаемое значение: новая ссылка. Часть Stable ABI.

Создаёт новый объект bytearray из string и его длины, len.

При ошибке возвращает NULL с установленным исключением.

PyObject *PyByteArray_Concat(PyObject *a, PyObject *b)¶

Возвращаемое значение: новая ссылка. Часть Stable ABI.

Объединяет байтовые массивы a и b и возвращает новый байтовый массив с результатом.

При ошибке возвращает NULL с установленным исключением.

Py_ssize_t PyByteArray_Size(PyObject *bytearray)¶: Часть Stable ABI.
Возвращает размер байтового массива после проверки указателя NULL.

char *PyByteArray_AsString(PyObject *bytearray)¶: Часть Stable ABI.
Возвращает содержимое байтового массива как массив char после проверки указателя NULL. Возвращаемый массив всегда содержит дополнительный нулевой байт в конце.

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)¶: Часть Stable ABI.
Изменяет размер внутреннего буфера bytearray до len.

Эти макросы жертвуют безопасностью ради скорости и не проверяют указатели.

char *PyByteArray_AS_STRING(PyObject *bytearray)¶: Аналогично PyByteArray_AsString(), но без проверки ошибок.

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)¶: Аналогично PyByteArray_Size(), но без проверки ошибок.