字节数组对象

type PyByteArrayObject

此 PyObject 的子类型表示一个 Python 字节数组对象。

PyTypeObject PyByteArray_Type

稳定 ABI 的一部分。

此 PyTypeObject 实例表示 Python 字节数组类型；它与 Python 层中的 bytearray 是同一个对象。

类型检查宏

int PyByteArray_Check(PyObject *o)

如果对象 o 是一个字节数组对象或字节数组类型的子类型的实例，则返回真。此函数始终成功。

int PyByteArray_CheckExact(PyObject *o)

如果对象 o 是一个字节数组对象，但不是字节数组类型的子类型的实例，则返回真。此函数始终成功。

直接 API 函数

PyObject *PyByteArray_FromObject(PyObject *o)

返回值：新引用。稳定 ABI 的一部分。

从任何实现 缓冲区协议 的对象 o 返回一个新的字节数组对象。

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

返回值：新引用。稳定 ABI 的一部分。

使用string及其长度len创建一个新的字节数组对象。如果失败，则返回NULL。

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

返回值：新引用。稳定 ABI 的一部分。

连接字节数组a和b，并返回一个包含结果的新字节数组。

Py_ssize_t PyByteArray_Size(PyObject *bytearray)

稳定 ABI 的一部分。

检查NULL指针后返回bytearray的大小。

char *PyByteArray_AsString(PyObject *bytearray)

稳定 ABI 的一部分。

检查NULL指针后，以字符数组的形式返回bytearray的内容。返回的数组始终附加一个额外的空字节。

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()，但没有错误检查。