이터레이터 프로토콜

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

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.