字节数组对象

2.6 版的新Function。

• PyByteArrayObject

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

• PyTypeObject PyByteArray_Type

  • PyTypeObject的实例表示 Python 字节数组类型；它与 Python 层中的bytearray是同Pair象。

类型检查宏

• int PyByteArray_Check(PyObject ** o *)

  • 如果对象* o *是字节数组对象或字节数组类型的子类型的实例，则返回 true。

• int PyByteArray_CheckExact(PyObject ** o *)

  • 如果对象* o *是字节数组对象，但不是字节数组类型的子类型的实例，则返回 true。

直接 API 函数

• PyObject * PyByteArray_FromObject(PyObject ** o *)

  • 从实现缓冲协议的任何对象* o *返回一个新的 bytearray 对象。

• PyObject * PyByteArray_FromStringAndSize(const char ** string *，Py_ssize_t * len *)

  • 从* string 及其长度 len 创建一个新的 bytearray 对象。失败时，返回 NULL *。

• PyObject * PyByteArray_Concat(PyObject *a ，PyObject b *)

  • 连接字节数组* a 和 b *，并返回一个新的字节数组及其结果。

• Py_ssize_t PyByteArray_Size(PyObject ** bytearray *)

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

• char * PyByteArray_AsString(PyObject ** bytearray *)

  • 检查* NULL 指针后，将 bytearray *的内容作为 char 数组返回。

• int PyByteArray_Resize(PyObject ** bytearray *，Py_ssize_t * len *)

  • 将* bytearray 的内部缓冲区的大小调整为 len *。

Macros

这些宏将安全性换成了速度，并且它们不检查指针。

• char * PyByteArray_AS_STRING(PyObject ** bytearray *)

  • PyByteArray_AsString()的宏版本。

• Py_ssize_t PyByteArray_GET_SIZE(PyObject ** bytearray *)

  • PyByteArray_Size()的宏版本。