字节数组对象

• 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 *)
  • 返回值：新参考.

从实现buffer protocol的任何对象* 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()的宏版本。