生成器对象¶
生成器对象是 Python 用来实现生成器迭代器的对象。它们通常通过迭代产生值的函数来创建，而不是显式调用 PyGen_New() 或 PyGen_NewWithQualName() 函数。
-
type PyGenObject¶
用于生成器对象的 C 结构体。
-
PyTypeObject PyGen_Type¶
与生成器对象对应的类型对象。
-
int PyGen_CheckExact(PyObject *ob)¶
如果 ob 的类型是
PyGen_Type则返回真值；ob 必须不为NULL。此函数总是会成功执行。
-
PyObject *PyGen_New(PyFrameObject *frame)¶
- 返回值：新的引用。
Create and return a new generator object based on the frame object. A reference to frame is "stolen" by this function (even on error). The argument must not be
NULL.从 3.16 版起已弃用，将在 3.18 版中移除: This function has not been used since 3.10. It is also impossible to construct a proper frame object to call this function.
-
PyObject *PyGen_NewWithQualName(PyFrameObject *frame, PyObject *name, PyObject *qualname)¶
- 返回值：新的引用。
Create and return a new generator object based on the frame object, with
__name__and__qualname__set to name and qualname. A reference to frame is "stolen" by this function (even on error). The frame argument must not beNULL.从 3.16 版起已弃用，将在 3.18 版中移除: This function has not been used since 3.10. It is also impossible to construct a proper frame object to call this function.
-
PyCodeObject *PyGen_GetCode(PyGenObject *gen)¶
返回一个新的指向 gen 所包装的代码对象的 strong reference。此函数总是会成功执行。
异步生成器对象¶
参见
-
PyTypeObject PyAsyncGen_Type¶
对应异步生成器对象的类型对象。它在 Python 层面上为
types.AsyncGeneratorType。Added in version 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 (even on error) and must not beNULL.成功时，此函数将返回一个指向新异步生成器的 strong reference。失败时，此函数将返回
NULL并设置一个异常。Added in version 3.6.
从 3.16 版起已弃用，将在 3.18 版中移除: This function has not been used since 3.10. It is also impossible to construct a proper frame object to call this function.
已弃用的 API¶
-
PyAsyncGenASend_CheckExact(op)¶
这个 API 是被错误地包括到 Python 的 C API 中的。
它出现在这里只是出于完整性考虑；请不要使用此 API。
自 3.14 版起已处于 Soft deprecated 状态.