# 產生器 (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`。

PyCodeObject *PyGen_GetCode(PyGenObject *gen)

  Return a new strong reference to the code object wrapped by gen. This function always succeeds.

## Asynchronous Generator Objects

也參考

PEP 525

PyTypeObject PyAsyncGen_Type

  The type object corresponding to asynchronous generator objects. This is available as `types.AsyncGeneratorType` in the Python layer.

  在 3.6 版被加入.

PyObject *PyAsyncGen_New(PyFrameObject *frame, PyObject *name, PyObject *qualname)

  Create a new asynchronous generator wrapping frame, with `__name__` and `__qualname__` set to name and qualname. frame is stolen by this function and must not be `NULL`.

  On success, this function returns a strong reference to the new asynchronous generator. On failure, this function returns `NULL` with an exception set.

  在 3.6 版被加入.

int PyAsyncGen_CheckExact(PyObject *op)

  Return true if op is an asynchronous generator object, false otherwise. This function always succeeds.

  在 3.6 版被加入.