Объекты байтового массива

Макросы проверки типа

int PyByteArray_Check(PyObject *o)

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

int PyByteArray_CheckExact(PyObject *o)

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

Функции прямого API

PyObject *PyByteArray_FromObject(PyObject *o)

Возвращаемое значение: новая ссылка. Входит в стабильный ABI.

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

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

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

Возвращаемое значение: новая ссылка. Входит в стабильный ABI.

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

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

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

Возвращаемое значение: новая ссылка. Входит в стабильный ABI.

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

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

Py_ssize_t PyByteArray_Size(PyObject *bytearray)

Входит в стабильный ABI.

Возвращает размер bytearray после проверки указателя на NULL.

char *PyByteArray_AsString(PyObject *bytearray)

Входит в стабильный ABI.

Возвращает содержимое bytearray в виде массива char после проверки указателя на NULL. В конец возвращаемого массива всегда добавляется дополнительный нулевой байт.

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)

Входит в стабильный ABI.

Изменяет размер внутреннего буфера bytearray на len.

Макросы

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

char *PyByteArray_AS_STRING(PyObject *bytearray)

Аналогичен PyByteArray_AsString(), но не выполняет проверку ошибок.

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)

Аналогичен PyByteArray_Size(), но не выполняет проверку ошибок.