Python 技術手冊 第三版

以 Python 的 C API 擴充 Python

|

735

代碼 C 型別 意義

y# char*+int

C 的 char 字串與長度轉為

bytes

，或

NULL

轉為

None

（僅限 v3）。

(...)

如每個

...

從 C 的值建置出 Python 元組（tuple）。

[...]

如每個

...

從 C 的值建置出 Python 串列（list）。

{...}

如每個

...

從 C 的值建置出Python 字典

（dictionary），鍵值與值交替出現（C 值的

數目必須為偶數）。

O&

代碼對應變數引數間的兩個引數：首先是你編寫的一個轉換器函式的位

址，然後是一個

void*

（即任何位址）。轉換器函式必須有特徵式

PyObject*

convert(void*)

。Python 會以來自變數引數的

void*

作為唯一引數呼叫那

個轉換函式。該轉換函式必須回傳

NULL

並提出一個例外（如第 5 章中所涵

蓋的）來表示錯誤，或回傳一個新的參考

PyObject*

，後者是從透過那個

void*

取得的資料建置出來的。

代碼

{...}

從整數個 C 值（鍵值與值交替出現）建置出字典。舉例來說，

Py_BuildValue("{issi}",23,"zig","zag",42)

會為

{23:'zig','zag':42}

回傳

一個新的

PyObject*

。

請注意，代碼

N

與

O

之間的關鍵差異。

N

會從變數引數間對應的

PyObject*

值

偷取

（

steals

）一個參考，所以很方便就能建置一個物件包含你擁有的一

個參考，否則你就得使用

Py_DECREF ...