# ジェネレータオブジェクト

ジェネレータオブジェクトは、 Python がジェネレータイテレータを実装するのに使っているオブジェクトです。ジェネレータオブジェクトは通常、 `PyGen_New()` や `PyGen_NewWithQualName()` の明示的な呼び出しではなく、値を yield する関数のイテレーションにより生成されます。

`PyGenObject`

  ジェネレータオブジェクトに使われている C 構造体です。

PyTypeObject `PyGen_Type`

  ジェネレータオブジェクトに対応する型オブジェクトです。

int `PyGen_Check`(PyObject *ob)

  ob がジェネレータオブジェクトの場合に真を返ます、 ob は `NULL` であってはなりません。この関数は常に成功します。

int `PyGen_CheckExact`(PyObject *ob)

  ob が `PyGen_Type` の場合に真を返します。 o は `NULL` であってはなりません。 この関数は常に成功します。

PyObject* `PyGen_New`(PyFrameObject *frame)
  Return value: New reference.

  frame オブジェクトに基づいて新たなジェネレータオブジェクトを生成して返します。 この関数は frame への参照を盗みます。 引数が `NULL` であってはなりません。

PyObject* `PyGen_NewWithQualName`(PyFrameObject *frame, PyObject *name, PyObject *qualname)
  Return value: New reference.

  frame オブジェクトから新たなジェネレータオブジェクトを生成し、 `__name__` と `__qualname__` を name と qualname に設定して返します。 この関数は frame への参照を盗みます。 frame 引数は `NULL` であってはなりません。