next(iterator)

next(iterator, default)

Функция вызывает next() указанного объекта для получения следующего элемента.

Параметры¶

• iter — Объект итератора, возвращающий элементы.
• iterator - next() извлекает следующий элемент из итератора
• default (необязательно) — значение, которое должно быть возвращено вместо возбуждения StopIteration, в случае исчерпания элементов при итерации.

Возвращаемое значение¶

Функция next() возвращает следующий элемент из итератора.

• Если итератор исчерпан, он возвращает значение по умолчанию, переданное в качестве аргумента.
• Если параметр по умолчанию опущен и итератор исчерпан, возникает исключение StopIteration.

Примеры¶

def generate():
    # Создадим итератор при помощи генератора.
    for value in [1, 2]:
        yield value

my_generator = generate()

next(my_generator)  # 1
next(my_generator)  # 2
next(my_generator)  # StopIteration

Для создания объекта итератора можно воспользоваться функцией iter().