# Protocolo iterador

Hay dos funciones específicas para trabajar con iteradores.

int PyIter_Check(PyObject *o)
  Part of the Stable ABI since version 3.8.

  Return non-zero if the object o can be safely passed to `PyIter_NextItem()` and `0` otherwise. This function always succeeds.

int PyAIter_Check(PyObject *o)
  Part of the Stable ABI since version 3.10.

  Retorna un valor distinto de cero si el objeto o proporciona el protocolo `AsyncIterator`, y `0` en caso contrario. Esta función siempre tiene éxito.

  Added in version 3.10.

int PyIter_NextItem(PyObject *iter, PyObject **item)
  Part of the Stable ABI since version 3.14.

  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)
  Return value: New reference. Part of the Stable ABI.

  This is an older version of `PyIter_NextItem()`, which is retained for backwards compatibility. Prefer `PyIter_NextItem()`.

  Retorna el siguiente valor del iterador o. El objeto debe ser un iterador según `PyIter_Check()` (depende del llamador verificar esto). Si no hay valores restantes, retorna `NULL` sin establecer una excepción. Si ocurre un error al recuperar el elemento, devuelve `NULL` y envía la excepción.

type PySendResult

  El valor de enumeración utilizado para representar diferentes resultados de `PyIter_Send()`.

  Added in version 3.10.

PySendResult PyIter_Send(PyObject *iter, PyObject *arg, PyObject **presult)
  Part of the Stable ABI since version 3.10.

  Envía el valor arg al iterador iter. Retorna:

  - `PYGEN_RETURN` si el iterador regresa. El valor de retorno se retorna a través de presult.

  - `PYGEN_NEXT` si el iterador cede. El valor cedido se retorna a través de presult.

  - `PYGEN_ERROR` si el iterador ha lanzado una excepción. presult se establece en `NULL`.

  Added in version 3.10.