產生器 (Generator) 物件

產生器物件是 Python 用來實現產生器疊代器 (generator iterator) 的物件。它們通常透過疊代會產生值的函式來建立,而不是顯式呼叫 PyGen_New()PyGen_NewWithQualName()

type PyGenObject

用於產生器物件的 C 結構。

PyTypeObject PyGen_Type

與產生器物件對應的型別物件。

int PyGen_Check(PyObject *ob)

如果 ob 是一個產生器 (generator) 物件則回傳真值;ob 必須不為 NULL。此函式總是會成功執行。

int PyGen_CheckExact(PyObject *ob)

如果 ob 的型別是 PyGen_Type 則回傳真值;ob 必須不為 NULL。此函式總是會成功執行。

PyObject *PyGen_New(PyFrameObject *frame)
回傳值:新的參照。

基於 frame 物件建立並回傳一個新的產生器物件。此函式會取走一個對 frame 的參照 (reference)。引數必須不為 NULL

PyObject *PyGen_NewWithQualName(PyFrameObject *frame, PyObject *name, PyObject *qualname)
回傳值:新的參照。

基於 frame 物件建立並回傳一個新的產生器物件,其中 __name____qualname__ 設為 namequalname。此函式會取走一個對 frame 的參照。frame 引數必須不為 NULL