字节数组对象
************

type PyByteArrayObject

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

PyTypeObject PyByteArray_Type
    * 属于 稳定 ABI.*

   Python bytearray 类型表示为 "PyTypeObject" 的实例；这与 Python 层面
   的 "bytearray" 是相同的对象。


类型检查宏
==========

int PyByteArray_Check(PyObject *o)

   如果对象 *o* 是一个 bytearray 对象或者 bytearray 类型的子类型的实例
   则返回真值。此函数总是会成功执行。

int PyByteArray_CheckExact(PyObject *o)

   如果对象 *o* 是一个 bytearray 对象但不是 bytearray 类型的子类型的实
   例则返回真值。此函数总是会成功执行。


直接 API 函数
=============

PyObject *PyByteArray_FromObject(PyObject *o)
    *返回值：新的引用。** 属于 稳定 ABI.** Thread safety: Safe for
   concurrent use on the same object.*

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

   当失败时，将返回 "NULL" 并设置一个异常。

   备注:

     如果对象实现了缓冲区协议，则缓冲区在 bytearray 对象创建时不可被修
     改。

PyObject *PyByteArray_FromStringAndSize(const char *string, Py_ssize_t len)
    *返回值：新的引用。** 属于 稳定 ABI.** Thread safety: Atomic.*

   根据 *string* 和它的长度 *len* 新建一个字节数组对象。

   当失败时，将返回 "NULL" 并设置一个异常。

PyObject *PyByteArray_Concat(PyObject *a, PyObject *b)
    *返回值：新的引用。** 属于 稳定 ABI.** Thread safety: Safe for
   concurrent use on the same object.*

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

   当失败时，将返回 "NULL" 并设置一个异常。

   备注:

     如果对象实现了缓冲区协议，则缓冲区在 bytearray 对象创建时不可被修
     改。

Py_ssize_t PyByteArray_Size(PyObject *bytearray)
    * 属于 稳定 ABI.** Thread safety: Atomic.*

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

char *PyByteArray_AsString(PyObject *bytearray)
    * 属于 稳定 ABI.** Thread safety: Safe to call from multiple
   threads with external synchronization only.*

   在检查 "NULL" 指针后将 *bytearray* 的内容作为一个字符数组返回。返回
   的数组总是会附加一个额外的空字节。

   备注:

     在使用返回的字符数组时修改 bytearray 对象将不是线程安全的。

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)
    * 属于 稳定 ABI.*

   将 *bytearray* 的内部缓冲区调整为 *len*。失败时返回 "-1"，并设置一
   个异常。

   在 3.14 版本发生变更: 现在，为负的 *len* 将导致异常并返回 -1。


宏
==

这些宏减低安全性以换取性能，它们不检查指针。

char *PyByteArray_AS_STRING(PyObject *bytearray)
    * Thread safety: Safe to call from multiple threads with external
   synchronization only.*

   类似于 "PyByteArray_AsString()"，但是不带错误检测。

   备注:

     在使用返回的字符数组时修改 bytearray 对象将不是线程安全的。

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)
    * Thread safety: Atomic.*

   类似于 "PyByteArray_Size()"，但是不带错误检测。
