`iter.md`

60 строк · 4.3 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.15/c-api/iter.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Протокол итератора89Есть две функции, предназначенные для работы с итераторами.1011#### `int PyIter_Check(PyObject *o)`1213*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable) с версии 3.8.*1415Возвращает ненулевое значение, если объект *o* можно безопасно передать в [`PyIter_NextItem()`](https://python-all.ru/3.15/c-api/iter.html#c.PyIter_NextItem), и `0` в противном случае. Эта функция всегда завершается успешно.1617#### `int PyAIter_Check(PyObject *o)`1819*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable) начиная с версии 3.10.*2021Возвращает ненулевое значение, если объект *o* предоставляет `AsyncIterator` протокол, и `0` в противном случае.2223Добавлено в версии 3.10.2425#### `int PyIter_NextItem(PyObject *iter, PyObject **item)`2627*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable) начиная с версии 3.14.*2829Возвращает `1` и устанавливает *item* в [сильная ссылка](https://python-all.ru/3.15/glossary.html#term-strong-reference) следующего значения итератора *iter* при успехе. Возвращает `0` и устанавливает *item* в `NULL`, если значений больше нет. Возвращает `-1`, устанавливает *item* в `NULL` и устанавливает исключение при ошибке.3031Добавлено в версии 3.14.3233#### `PyObject *PyIter_Next(PyObject *o)`3435*Возвращаемое значение: новая ссылка.*3637*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*3839Это старая версия `PyIter_NextItem()`, которая сохранена для обратной совместимости. Предпочтительнее использовать [`PyIter_NextItem()`](https://python-all.ru/3.15/c-api/iter.html#c.PyIter_NextItem).4041Возвращает следующее значение из итератора *o*. Объект должен быть итератором согласно [`PyIter_Check()`](https://python-all.ru/3.15/c-api/iter.html#c.PyIter_Check) (проверка этого возлагается на вызывающего). Если значений больше нет, возвращает `NULL` без установки исключения. Если при получении элемента происходит ошибка, возвращает `NULL` и передаёт исключение.4243#### `type PySendResult`4445Значение перечисления, используемое для представления различных результатов [`PyIter_Send()`](https://python-all.ru/3.15/c-api/iter.html#c.PyIter_Send).4647Добавлено в версии 3.10.4849#### `PySendResult PyIter_Send(PyObject *iter, PyObject *arg, PyObject **presult)`5051*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable) начиная с версии 3.10.*5253Отправляет значение *arg* в итератор *iter*. Возвращает:5455- `PYGEN_RETURN`, если итератор возвращает значение. Возвращаемое значение передаётся через *presult*.56- `PYGEN_NEXT`, если итератор выдаёт значение. Полученное значение передаётся через *presult*.57- `PYGEN_ERROR`, если итератор возбудил исключение. *presult* устанавливается в `NULL`.5859Добавлено в версии 3.10.60