iter()

iter(object[, sentinel])

该函数会返回一个 iterator 对象。第一个实参(argument)会因为第二个实参的传入，而获得截然不同的解释。

在没有传入第二个实参的情况下，object 必须是一个支持迭代协议( __iter__() 方法)的集合(collection)对象；或者 object 必须支持序列协议 (the __getitem__() method with integer arguments starting at 0)。如果这两种协议均不被 object 支持，iter() 便会抛出 TypeError。Tips：这里提到的集合对象只是一种抽象概念，并非特指 Callable 类型，仅实现 __iter__() 方法即可支持 iter 函数；同样的，仅实现 __getitem__() 方法也能支持 iter 函数

class ObjcIter:
    def __iter__(self):
        cont = 0
        while cont < 3:
            cont += 1
            yield cont


a_iter1 = iter(ObjcIter())
print(list(a_iter1))


class ObjcGetitem:
    def __getitem__(self, item):
        cont = 0

        while cont <= item:
            cont += 1
            if cont >= 5:
                raise StopIteration()
        return cont


a_iter2 = iter(ObjcGetitem())
print(list(a_iter2))

输出：

[1, 2, 3]
[1, 2, 3, 4]

如果传入了第二参数 sentinel，此时 object 必须是一个可调用(callable)对象。对于在这种情况下创建的迭代器，每当调用其 __next__() 方法时，便会以无参数形式调用 object。如果 object 的返回值等于 sentinel，便会抛出 StopIteration ；如果返回值不等于 sentinel，则直接返回该值。比如下面这个示例：

class AutoIncrement(object):
    """每次调用该类的实例，计数器便会自动加1"""

    def __init__(self):
        self._count = 0

    def __call__(self):
        self._count += 1
        return self._count


a_iter = AutoIncrement()
for i in iter(a_iter, 3):
    # 当a_iter()返回5时，便会抛出StopIteration
    # 停止迭代
    print(i, end=',')

输出：

1,2,

还可参考：Iterator Types.

iter() 的第二种使用形式的一个使用场景是：可以一次性读取文件中的多个行，并在某个特定行停止读取。下面这个示例会持续读取一个文件，直到 readline() 方法返回空字符串为止。

with open('mydata.txt') as fp:
    for line in iter(fp.readline, ''):
        process_line(line)