Iterator Protocol

2.2 版中的新Function。

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

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

在老式类的情况下,此函数可能返回假肯定,因为这些类始终使用带有调用next()方法或引发TypeError的逻辑来定义tp_iternext插槽。

从迭代* 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 */
}