Iterator Protocol

有两个专门用于迭代器的Function。

  • int PyIter_Check(PyObject ** o *)

    • 如果对象* o *支持迭代器协议,则返回 true。
  • PyObject * PyIter_Next(PyObject ** o *)

    • 返回值:新参考.

从迭代* o *返回下一个值。该对象必须是一个迭代器(由调用者检查)。如果没有剩余值,则返回NULL且未设置任何异常。如果在检索项目时发生错误,则返回NULL并传递异常。

要编写循环遍历迭代器的循环,C 代码应如下所示:

PyObject *iterator = PyObject_GetIter(obj);
PyObject *item;

if (iterator == NULL) {
    /* propagate error */
}

while ((item = PyIter_Next(iterator))) {
    /* do something with item */
    ...
    /* release reference when done */
    Py_DECREF(item);
}

Py_DECREF(iterator);

if (PyErr_Occurred()) {
    /* propagate error */
}
else {
    /* continue doing useful work */
}