# 產生器 (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__` 設為 name 和 qualname。此函式會取走一個對 frame 的參照。frame 引數必須不為 `NULL`。