# Itérateurs

Python provides two general-purpose iterator objects. The first, a sequence iterator, works with an arbitrary sequence supporting the `__getitem__()` method. The second works with a callable object and a sentinel value, calling the callable for each item in the sequence, and ending the iteration when the sentinel value is returned.

PyTypeObject PySeqIter_Type
  Fait partie de l' ABI stable.

  Type des itérateurs renvoyés par les fonctions `PySeqIter_New()` et la forme à un argument de la fonction native `iter()` pour les séquences natives.

int PySeqIter_Check(PyObject *op)

  Return true if the type of op is `PySeqIter_Type`. This function always succeeds.

PyObject *PySeqIter_New(PyObject *seq)
  Valeur de retour : nouvelle référence. Fait partie de l' ABI stable.

  Renvoie un itérateur sur la séquence seq. L'itération prend fin lorsque la séquence lève `IndexError` lors d'une tentative d'accès.

PyTypeObject PyCallIter_Type
  Fait partie de l' ABI stable.

  Type de l'itérateur renvoyé par les fonctions `PyCallIter_New()` et `iter()` à deux arguments.

int PyCallIter_Check(PyObject *op)

  Return true if the type of op is `PyCallIter_Type`. This function always succeeds.

PyObject *PyCallIter_New(PyObject *callable, PyObject *sentinel)
  Valeur de retour : nouvelle référence. Fait partie de l' ABI stable.

  Renvoie un nouvel itérateur. Le premier paramètre, callable, peut être n'importe quel objet Python appelable sans aucun paramètre ; chaque appel doit renvoyer l'élément suivant de l'itération. Lorsque callable renvoie une valeur égale à sentinel, l'itération prend fin.

## Range Objects

PyTypeObject PyRange_Type
  Fait partie de l' ABI stable.

  The type object for `range` objects.

int PyRange_Check(PyObject *o)

  Return true if the object o is an instance of a `range` object. This function always succeeds.

## Builtin Iterator Types

These are built-in iteration types that are included in Python's C API, but provide no additional functions. They are here for completeness.

C type | Python type
--- | ---

PyTypeObject PyEnum_Type
  Fait partie de l' ABI stable.

`enumerate`

PyTypeObject PyFilter_Type
  Fait partie de l' ABI stable.

`filter`

PyTypeObject PyMap_Type
  Fait partie de l' ABI stable.

`map`

PyTypeObject PyReversed_Type
  Fait partie de l' ABI stable.

`reversed`

PyTypeObject PyZip_Type
  Fait partie de l' ABI stable.

`zip`

## Other Iterator Objects

PyTypeObject PyByteArrayIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyBytesIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyListIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyListRevIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PySetIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyTupleIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyRangeIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyLongRangeIter_Type
  Fait partie de l' ABI stable.

PyTypeObject PyDictIterKey_Type
  Fait partie de l' ABI stable.

PyTypeObject PyDictRevIterKey_Type
  Fait partie de l' ABI stable depuis la version 3.8.

PyTypeObject PyDictIterValue_Type
  Fait partie de l' ABI stable.

PyTypeObject PyDictRevIterValue_Type
  Fait partie de l' ABI stable depuis la version 3.8.

PyTypeObject PyDictIterItem_Type
  Fait partie de l' ABI stable.

PyTypeObject PyDictRevIterItem_Type
  Fait partie de l' ABI stable depuis la version 3.8.

PyTypeObject PyODictIter_Type

  Type objects for iterators of various built-in objects.

  Do not create instances of these directly; prefer calling `PyObject_GetIter()` instead.

  Note that there is no guarantee that a given built-in type uses a given iterator type. For example, iterating over `range` will use one of two iterator types depending on the size of the range. Other types may start using a similar scheme in the future, without warning.