bytes 對象?

These functions raise TypeError when expecting a bytes parameter and called with a non-bytes parameter.

type PyBytesObject?

這種 PyObject 的子類型表示一個 Python 字節(jié)對象。

PyTypeObject PyBytes_Type?
Part of the Stable ABI.

PyTypeObject 的實例代表一個 Python 字節(jié)類型，在 Python 層面它與 bytes 是相同的對象。

int PyBytes_Check(PyObject *o)?

如果對象 o 是一個 bytes 對象或者 bytes 類型的子類型的實例則返回真值。 此函數總是會成功執(zhí)行。

int PyBytes_CheckExact(PyObject *o)?

如果對象 o 是一個 bytes 對象但不是 bytes 類型的子類型的實例則返回真值。 此函數總是會成功執(zhí)行。

PyObject *PyBytes_FromString(const char *v)?
Return value: New reference. Part of the Stable ABI.

成功時返回一個以字符串 v 的副本為值的新字節(jié)串對象，失敗時返回 NULL。 形參 v 不可為 NULL；它不會被檢查。

PyObject *PyBytes_FromStringAndSize(const char *v, Py_ssize_t len)?
Return value: New reference. Part of the Stable ABI.

成功時返回一個以字符串 v 的副本為值且長度為 len 的新字節(jié)串對象，失敗時返回 NULL。 如果 v 為 NULL，則不初始化字節(jié)串對象的內容。

PyObject *PyBytes_FromFormat(const char *format, ...)?
Return value: New reference. Part of the Stable ABI.

接受一個 C printf() 風格的 format 字符串和可變數量的參數，計算結果 Python 字節(jié)串對象的大小并返回參數值經格式化后的字節(jié)串對象。 可變數量的參數必須均為 C 類型并且必須恰好與 format 字符串中的格式字符相對應。 允許使用下列格式字符串:

格式字符

類型

注釋

%%

不適用

文字%字符。

%c

int

一個字節(jié)，被表示為一個 C 語言的整型

%d

int

相當于 printf("%d"). 1

%u

unsigned int

相當于 printf("%u"). 1

%ld

長整型

相當于 printf("%ld"). 1

%lu

unsigned long

相當于 printf("%lu"). 1

%zd

Py_ssize_t

相當于 printf("%zd"). 1

%zu

size_t

相當于 printf("%zu"). 1

%i

int

相當于 printf("%i"). 1

%x

int

相當于 printf("%x"). 1

%s

const char*

以 null 為終止符的 C 字符數組。

%p

const void*

一個 C 指針的十六進制表示形式。 基本等價于 printf("%p") 但它會確保以字面值 0x 開頭，不論系統(tǒng)平臺上 printf 的輸出是什么。

無法識別的格式字符會導致將格式字符串的其余所有內容原樣復制到結果對象，并丟棄所有多余的參數。

1(1,2,3,4,5,6,7,8)

對于整數說明符（d，u，ld，lu，zd，zu，i，x）：當給出精度時，0 轉換標志是有效的。

PyObject *PyBytes_FromFormatV(const char *format, va_list vargs)?
Return value: New reference. Part of the Stable ABI.

與 PyBytes_FromFormat() 完全相同，除了它需要兩個參數。

PyObject *PyBytes_FromObject(PyObject *o)?
Return value: New reference. Part of the Stable ABI.

返回字節(jié)表示實現(xiàn)緩沖區(qū)協(xié)議的對象*o*。

Py_ssize_t PyBytes_Size(PyObject *o)?
Part of the Stable ABI.

返回字節(jié)對象*o*中字節(jié)的長度。

Py_ssize_t PyBytes_GET_SIZE(PyObject *o)?

Similar to PyBytes_Size(), but without error checking.

char *PyBytes_AsString(PyObject *o)?
Part of the Stable ABI.

返回對應 o 的內容的指針。 該指針指向 o 的內部緩沖區(qū)，其中包含 len(o) + 1 個字節(jié)。 緩沖區(qū)的最后一個字節(jié)總是為空，不論是否存在其他空字節(jié)。 該數據不可通過任何形式來修改，除非是剛使用 PyBytes_FromStringAndSize(NULL, size) 創(chuàng)建該對象。 它不可被撤銷分配。 如果 o 根本不是一個字節(jié)串對象，則 PyBytes_AsString() 將返回 NULL 并引發(fā) TypeError。

char *PyBytes_AS_STRING(PyObject *string)?

Similar to PyBytes_AsString(), but without error checking.

int PyBytes_AsStringAndSize(PyObject *obj, char **buffer, Py_ssize_t *length)?
Part of the Stable ABI.

通過輸出變量 buffer 和 length 返回以 null 為終止符的對象 obj 的內容。

如果 length 為 NULL，字節(jié)串對象就不包含嵌入的空字節(jié)；如果包含，則該函數將返回 -1 并引發(fā) ValueError。

該緩沖區(qū)指向 obj 的內部緩沖，它的末尾包含一個額外的空字節(jié)（不算在 length 當中）。 該數據不可通過任何方式來修改，除非是剛使用 PyBytes_FromStringAndSize(NULL, size) 創(chuàng)建該對象。 它不可被撤銷分配。 如果 obj 根本不是一個字節(jié)串對象，則 PyBytes_AsStringAndSize() 將返回 -1 并引發(fā) TypeError。

在 3.5 版更改: 以前，當字節(jié)串對象中出現(xiàn)嵌入的空字節(jié)時將引發(fā) TypeError。

void PyBytes_Concat(PyObject **bytes, PyObject *newpart)?
Part of the Stable ABI.

在 *bytes 中創(chuàng)建新的字節(jié)串對象，其中包含添加到 bytes 的 newpart 的內容；調用者將獲得新的引用。 對 bytes 原值的引用將被收回。 如果無法創(chuàng)建新對象，對 bytes 的舊引用仍將被丟棄且 *bytes 的值將被設為 NULL；并將設置適當的異常。

void PyBytes_ConcatAndDel(PyObject **bytes, PyObject *newpart)?
Part of the Stable ABI.

在 *bytes 中創(chuàng)建新的字節(jié)串對象，其中包含添加到 bytes 的 newpart 的內容。 此版本會減少 newpart 的引用計數。

int _PyBytes_Resize(PyObject **bytes, Py_ssize_t newsize)?

改變字節(jié)串大小的一種方式，即使其為“不可變對象”。 此方式僅用于創(chuàng)建全新的字節(jié)串對象；如果字節(jié)串在代碼的其他部分已知則不可使用此方式。 如果輸入字節(jié)串對象的引用計數不為一則調用此函數將報錯。 傳入一個現(xiàn)有字節(jié)串對象的地址作為 lvalue（它可能會被寫入），并傳入希望的新大小。 當成功時，*bytes 將存放改變大小后的字節(jié)串對象并返回 0；*bytes 中的地址可能與其輸入值不同。 如果重新分配失敗，則 *bytes 上的原字節(jié)串對象將被撤銷分配，*bytes 會被設為 NULL，同時設置 MemoryError 并返回 -1。