iter.md

1> **Источник:** https://python-all.ru/3.0/c-api/iter.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Протокол итератора89Есть всего несколько функций, специально предназначенных для работы с итераторами.1011**\[PyIter\_Check\]int `PyIter_Check`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**1213Возвращает истину, если объект1415*o*1617поддерживает протокол итератора.1819**\[PyIter\_Next\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PyIter_Next`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**2021*Возвращаемое значение: новая ссылка.*2223Возвращает следующее значение из итерации *o*. Если объект является итератором, извлекает следующее значение из итерации и возвращает *NULL* без установленного исключения, если не осталось элементов. Если объект не является итератором, возбуждается [`TypeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.TypeError), или, если при извлечении элемента произошла ошибка, возвращает *NULL* и передаёт исключение.2425Чтобы написать цикл, который выполняет итерацию по итератору, код на C должен выглядеть примерно так:2627```c28PyObject *iterator = PyObject_GetIter(obj);29PyObject *item;3031if (iterator == NULL) {32    /* распространить ошибку */33}3435while (item = PyIter_Next(iterator)) {36    /* сделать что-то с элементом */37    ...38    /* освободить ссылку по завершении */39    Py_DECREF(item);40}4142Py_DECREF(iterator);4344if (PyErr_Occurred()) {45    /* распространить ошибку */46}47else {48    /* продолжить выполнение полезной работы */49}50```51