Python next() ビルトイン関数

Python 3 ドキュメントより

イテレータの __next__() メソッドを呼び出して、イテレータから次の項目を取得します。default が指定されている場合、イテレータが枯渇するとそれが返されます。指定されていない場合は、StopIteration が送出されます。

Introduction

next() 関数は、イテレータから次の項目を取得します。イテレータが枯渇すると、StopIteration 例外が発生します。

イテレータが枯渇した場合に返されるデフォルト値を指定することもでき、これにより StopIteration 例外を防ぐことができます。

Examples

イテレータを使用した next() の使用:

my_list = [1, 2]
my_iter = iter(my_list)

print(next(my_iter))
print(next(my_iter))

try:
    print(next(my_iter))
except StopIteration:
    print("Iterator is exhausted")
1
2
Iterator is exhausted

デフォルト値を使用した next() の使用:

my_iter = iter([1])
print(next(my_iter, "default"))
print(next(my_iter, "default"))
1
default

その他の例:

i = iter([1, 2, 3])
print(next(i))
print(next(i))
print(next(i))
1
2
3