字节数组对象 — Python 3.14.5 文档
Description: 类型检查宏: 直接 API 函数: 宏: 这些宏减低安全性以换取性能，它们不检查指针。

# 字节数组对象

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()`，但是不带错误检测。