字节数组对象

类型 PyByteArrayObject

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

PyTypeObject PyByteArray_Type

属于 稳定 ABI 的一部分。

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

类型检查宏

int PyByteArray_Check(PyObject *o)

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

int PyByteArray_CheckExact(PyObject *o)

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

直接 API 函数

PyObject *PyByteArray_FromObject(PyObject *o)

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

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

如果失败，则返回 NULL 并设置一个异常。

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

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

从 string 及其长度 len 创建一个新的字节数组对象。

如果失败，则返回 NULL 并设置一个异常。

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

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

连接字节数组 a 和 b 并返回一个新的带有结果的字节数组。

如果失败，则返回 NULL 并设置一个异常。

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