疊代器（Iterator）物件
**********************

Python 提供了两个通用迭代器对象。 第一个是序列迭代器，它可与支持
"__getitem__()" 方法的任意序列一起使用。 第二个迭代器使用一个可调用对
象和一个哨兵值，为序列中的每个项目调用可调用对象，并在返回哨兵值时结束
迭代。

PyTypeObject PySeqIter_Type
    * 属于 稳定 ABI.*

   "PySeqIter_New()" 返回迭代器对象的类型对象和内置序列类型内置函数
   "iter()" 的单参数形式。

int PySeqIter_Check(PyObject *op)

   如果 *op* 的类型为 "PySeqIter_Type" 则返回真值。 此函数总是会成功执
   行。

PyObject *PySeqIter_New(PyObject *seq)
    *回傳值：新的參照。** 属于 稳定 ABI.*

   返回一个与常规序列对象一起使用的迭代器 *seq*。 当序列订阅操作引发
   "IndexError" 时，迭代结束。

PyTypeObject PyCallIter_Type
    * 属于 稳定 ABI.*

   由函数 "PyCallIter_New()" 和 "iter()" 内置函数的双参数形式返回的迭
   代器对象类型对象。

int PyCallIter_Check(PyObject *op)

   如果 *op* 的类型为 "PyCallIter_Type" 则返回真值。 此函数总是会成功
   执行。

PyObject *PyCallIter_New(PyObject *callable, PyObject *sentinel)
    *回傳值：新的參照。** 属于 稳定 ABI.*

   返回一个新的迭代器。 第一个参数 *callable* 可以是任何可以在没有参数
   的情况下调用的 Python 可调用对象；每次调用都应该返回迭代中的下一个
   项目。 当 *callable* 返回等于 *sentinel* 的值时，迭代将终止。
