# 이터레이터 프로토콜

특히 이터레이터를 사용하기 위한 두 함수가 있습니다.

int PyIter_Check(PyObject *o)
  Part of the 안정 ABI 버전 3.8 이후로.

  객체 o가 `PyIter_Next()`에 안전하게 전달될 수 있으면 `0`이 아닌 값을, 그렇지 않으면 `0`을 돌려줍니다. 이 함수는 항상 성공합니다.

int PyAIter_Check(PyObject *o)
  Part of the 안정 ABI 버전 3.10 이후로.

  객체 o가 `AsyncIterator` 프로토콜을 지원하면 `0`이 아닌 값을, 그렇지 않으면 `0`을 돌려줍니다. 이 함수는 항상 성공합니다.

  Added in version 3.10.

PyObject *PyIter_Next(PyObject *o)
  반환값: 새 참조. Part of the 안정 ABI.

  이터레이터 o에서 다음 값을 반환합니다. 객체는 `PyIter_Check()`에 따르는 이터레이터 여야 합니다 (이것을 확인하는 것은 호출자 책임입니다). 남은 값이 없으면, 예외가 설정되지 않은 상태로 `NULL`을 반환합니다. 항목을 꺼내는 동안 에러가 발생하면, `NULL`을 반환하고 예외를 전달합니다.

이터레이터를 이터레이트하는 루프를 작성하려면, C 코드는 이런 식으로 되어야 합니다:

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

    if (iterator == NULL) {
        /* 에러를 전파합니다 */
    }

    while ((item = PyIter_Next(iterator))) {
        /* item으로 뭔가 합니다 */
        ...
        /* 끝나면 참조를 반환합니다 */
        Py_DECREF(item);
    }

    Py_DECREF(iterator);

    if (PyErr_Occurred()) {
        /* 에러를 전파합니다 */
    }
    else {
        /* 쓸모있는 일을 계속합니다 */
    }

type PySendResult

  The enum value used to represent different results of `PyIter_Send()`.

  Added in version 3.10.

PySendResult PyIter_Send(PyObject *iter, PyObject *arg, PyObject **presult)
  Part of the 안정 ABI 버전 3.10 이후로.

  Sends the arg value into the iterator iter. Returns:

  - `PYGEN_RETURN` if iterator returns. Return value is returned via presult.

  - `PYGEN_NEXT` if iterator yields. Yielded value is returned via presult.

  - `PYGEN_ERROR` if iterator has raised and exception. presult is set to `NULL`.

  Added in version 3.10.