This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release.

# イテレータオブジェクト (iterator object)

Python では二種類のイテレータオブジェクトを提供しています。一つ目はシーケンスイテレータで、 `__getitem__()` メソッドをサポートする任意のシーケンスを取り扱います。二つ目は呼び出し可能オブジェクトとセンチネル値 (sentinel value) を扱い、シーケンス内の要素ごとに呼び出し可能オブジェクトを呼び出して、センチネル値が返されたときに反復処理を終了します。

PyTypeObject `PySeqIter_Type`

  `PySeqIter_New()` や、組み込みシーケンス型に対して 1 引数形式の組み込み関数 `iter()` を呼び出したときに返される、イテレータオブジェクトの型オブジェクトです。

  バージョン 2.2 で追加.

int `PySeqIter_Check`(op)

  `PySeqIter_Type` の型が op のときに真を返します。

  バージョン 2.2 で追加.

PyObject* `PySeqIter_New`(PyObject *seq)
  Return value: New reference.

  一般的なシーケンスオブジェクト seq を扱うイテレータを返します。反復処理は、シーケンスが添字指定操作の際に `IndexError` を返したときに終了します。

  バージョン 2.2 で追加.

PyTypeObject `PyCallIter_Type`

  `PyCallIter_New()` や、組み込み関数 `iter()` の 2 引数形式が返すイテレータオブジェクトの型オブジェクトです。 `iter()` built-in function.

  バージョン 2.2 で追加.

int `PyCallIter_Check`(op)

  op の型が `PyCallIter_Type` のときに真を返します。

  バージョン 2.2 で追加.

PyObject* `PyCallIter_New`(PyObject *callable, PyObject *sentinel)
  Return value: New reference.

  新たなイテレータを返します。最初のパラメタ callable は引数なしで呼び出せる Python の呼び出し可能オブジェクトならなんでもかまいません; callable は、呼び出されるたびに次の反復処理対象オブジェクトを返さなければなりません。生成されたイテレータは、callable が sentinel に等しい値を返すと反復処理を終了します。

  バージョン 2.2 で追加.