Функция anext( ) в Python

Функция anext(async_iterator[, default]) в Python используется для получения следующего элемента из асинхронного итератора. Если итератор завершился, можно указать значение по умолчанию, которое будет возвращено, чтобы избежать возникновения исключения StopAsyncIteration.

Синтаксис

anext(async_iterator[, default])

Где:

• async_iterator — асинхронный итератор, из которого нужно получить следующий элемент.
• default (опционально) — значение, которое будет возвращено в случае окончания итератора. Если не указано, итерирование завершится с исключением StopAsyncIteration.

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

Функция возвращает следующий элемент из асинхронного итератора. Если итератор завершился и указано значение default, функция возвращает это значение. В противном случае выбрасывается исключение StopAsyncIteration.

Примеры использования

Пример 1: Использование без значения по умолчанию

import asyncio

async def async_generator():
    for i in range(3):
        await asyncio.sleep(1)
        yield i

async def main():
    agen = async_generator()
    print(await anext(agen))  # Вывод: 0
    print(await anext(agen))  # Вывод: 1
    print(await anext(agen))  # Вывод: 2
    try:
        print(await anext(agen))
    except StopAsyncIteration:
        print("Итерация завершена")  # Вывод: Итерация завершена

asyncio.run(main())

В этом примере асинхронный генератор async_generator возвращает значения от 0 до 2 с задержкой в 1 секунду между каждым значением. Функция anext используется для получения следующего элемента из генератора до тех пор, пока он не завершится.

Пример 2: Использование со значением по умолчанию

import asyncio

async def async_generator():
    for i in range(3):
        await asyncio.sleep(1)
        yield i

async def main():
    agen = async_generator()
    print(await anext(agen, 'default'))  # Вывод: 0
    print(await anext(agen, 'default'))  # Вывод: 1
    print(await anext(agen, 'default'))  # Вывод: 2
    print(await anext(agen, 'default'))  # Вывод: default

asyncio.run(main())