> **Источник:** https://python-all.ru/2.7/c-api/iter.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# Протокол итератора

Новое в версии 2.2.

Есть две функции, предназначенные для работы с итераторами.

#### `int PyIter_Check(PyObject *o)`

Возвращает истину, если объект *o* поддерживает протокол итератора.

Эта функция может давать ложноположительный результат для классов старого стиля, поскольку такие классы всегда определяют слот `tp_iternext`, логика которого либо вызывает метод [`next()`](https://python-all.ru/2.7/library/functions.html#next), либо порождает [`TypeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.TypeError).

#### `PyObject* PyIter_Next(PyObject *o)`

*Возвращаемое значение: новая ссылка.*

Возвращает следующее значение из итерации *o*. Объект должен быть итератором (проверка возлагается на вызывающую сторону). Если значений больше нет, возвращает *NULL* без установки исключения. Если при получении элемента возникает ошибка, возвращает *NULL* и передаёт исключение дальше.

Чтобы написать цикл, который выполняет итерацию по итератору, код на C должен выглядеть примерно так:

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

if (iterator == NULL) {
    /* распространить ошибку */
}

while ((item = PyIter_Next(iterator))) {
    /* сделать что-то с элементом */
    ...
    /* освободить ссылку по завершении */
    Py_DECREF(item);
}

Py_DECREF(iterator);

if (PyErr_Occurred()) {
    /* распространить ошибку */
}
else {
    /* продолжить выполнение полезной работы */
}
```