位元組陣列物件

型別 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 的內容作為字元陣列返回。返回的陣列總是附加一個額外的空位元組。

int PyByteArray_Resize(PyObject *bytearray, Py_ssize_t len)

屬於 穩定 ABI 的一部分。

將 bytearray 的內部緩衝區大小調整為 len。

宏

這些宏以犧牲安全性來換取速度，並且它們不檢查指標。

char *PyByteArray_AS_STRING(PyObject *bytearray)

類似於 PyByteArray_AsString()，但沒有錯誤檢查。

Py_ssize_t PyByteArray_GET_SIZE(PyObject *bytearray)

類似於 PyByteArray_Size()，但沒有錯誤檢查。