Python

이터레이터 프로토콜

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

int PyIter_Check(PyObject *o)
…의 일부 안정 ABI 버전 3.8 이후로.

객체 o 를 PyIter_NextItem() 에 안전하게 전달할 수 있으면 0이 아닌 값을 반환하고, 그렇지 않으면 0 을 반환합니다. 이 함수는 항상 성공합니다.

int PyAIter_Check(PyObject *o)
…의 일부 안정 ABI 버전 3.10 이후로.

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

Added in version 3.10.

int PyIter_NextItem(PyObject *iter, PyObject **item)
…의 일부 안정 ABI 버전 3.14 이후로.

[msgid] Return 1 and set item to a strong reference of the next value of the iterator iter on success. Return 0 and set item to NULL if there are no remaining values. Return -1, set item to NULL and set an exception on error.

Added in version 3.14.

PyObject *PyIter_Next(PyObject *o)
반환값: 새 참조. …의 일부 안정 ABI.

이것은 하위 호환성을 위해 유지되는 PyIter_NextItem() 의 구버전입니다. PyIter_NextItem() 을 사용하는 것을 권장합니다.

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

type PySendResult

PyIter_Send() 의 다양한 결과를 나타내는 데 사용되는 열거형(enum) 값입니다.

Added in version 3.10.

PySendResult PyIter_Send(PyObject *iter, PyObject *arg, PyObject **presult)
…의 일부 안정 ABI 버전 3.10 이후로.

arg 값을 이터레이터 iter 로 보냅니다. 다음을 반환합니다:

  • 이터레이터가 종료되면 PYGEN_RETURN 을 반환합니다. 반환 값은 presult 를 통해 제공됩니다.

  • 이터레이터가 값을 내놓으면(yield) PYGEN_NEXT 를 반환합니다. 생성된 값은 presult 를 통해 제공됩니다.

  • 이터레이터가 예외를 발생시키면 PYGEN_ERROR 를 반환합니다. presult 은 NULL 로 설정됩니다.

Added in version 3.10.