Spec-Zone.ru › Python 3.13

Объекты bytearray

type PyByteArrayObject

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

PyTypeObject PyByteArray_Type
Часть стабильного ABI.

Этот экземпляр PyTypeObject представляет тип Python bytearray; на уровне Python это тот же объект, что и bytearray.

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

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(), но без проверки ошибок.

© 2001–2025 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.13/c-api/bytearray.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API