# 生成器对象

生成器对象是Python用来实现生成器迭代器的对象。它们通常通过迭代产生值的函数来创建，而不是显式调用 `PyGen_New()` 或 `PyGen_NewWithQualName()`。

type `PyGenObject`

  用于生成器对象的C结构体。

type `PySendResult`

  The enum value used to represent different results of `PyGen_Send()`.

PyTypeObject `PyGen_Type`

  与生成器对象对应的类型对​​象。

int `PyGen_Check`(PyObject *ob)

  如果 ob 是一个生成器对象则返回真值；ob 必须不为 `NULL`。

int `PyGen_CheckExact`(PyObject *ob)

  如果 ob 的类型为 `PyGen_Type` 则返回真值；ob 必须不为 `NULL`。

PyObject *`PyGen_New`(PyFrameObject *frame)

  基于 frame 对象创建并返回一个新的生成器对象。 此函数会取走一个对 frame 的引用。 参数必须不为 `NULL`。

PyObject *`PyGen_NewWithQualName`(PyFrameObject *frame, PyObject *name, PyObject *qualname)

  基于 frame 对象创建并返回一个新的生成器对象，其中 `__name__` 和 `__qualname__` 设为 name 和 qualname。 此函数会取走一个对 frame 的引用。 frame 参数必须不为 `NULL`。

PySendResult `PyGen_Send`(PyGenObject *gen, PyObject *arg, PyObject **presult)

  Sends the arg value into the generator gen. Coroutine objects are also allowed to be as the gen argument but they need to be explicitly casted to PyGenObject*. Returns:

  - `PYGEN_RETURN` if generator returns. Return value is returned via presult.

  - `PYGEN_NEXT` if generator yields. Yielded value is returned via presult.

  - `PYGEN_ERROR` if generator has raised and exception. presult is set to `NULL`.