字节数组对象

类型 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 的内容作为 char 数组返回。返回的数组总是附加一个额外的 null 字节。

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)

作为 稳定 ABI 的一部分。

将 bytearray 的内部缓冲区大小调整为 len。失败时返回 -1 并设置异常。

3.14 版本中已更改: 负的 len 现在将导致设置异常并返回 -1。

宏

这些宏以安全性换取速度，它们不检查指针。

char *PyByteArray_AS_STRING(PyObject *bytearray)

类似于 PyByteArray_AsString()，但没有错误检查。

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)

类似于 PyByteArray_Size()，但没有错误检查。