Python 的内置函数 anext

Python 的内置函数 anext 是 Python 3.10 版本中新增的一个异步迭代器函数，专门用于异步获取迭代器的下一个值。它是传统同步 next() 函数的异步版本，主要用于异步编程环境中。

函数原型

async def anext(async_iterator, default=...)

参数说明

1. async_iterator：必需的异步迭代器对象
2. default：可选参数，当迭代器耗尽时返回的默认值（如果不提供且迭代器耗尽，会抛出 StopAsyncIteration 异常）

工作原理

anext 会：

1. 调用异步迭代器的 __anext__() 方法
2. 等待返回的 awaitable 对象
3. 返回获取到的值或默认值（如果提供）

使用示例

async def async_range(n):
    for i in range(n):
        yield i

async def main():
    async for num in async_range(3):
        print(num)  # 输出 0, 1, 2

    # 使用 anext
    it = async_range(3)
    print(await anext(it))  # 输出 0
    print(await anext(it))  # 输出 1
    print(await anext(it))  # 输出 2
    print(await anext(it, "end"))  # 输出 "end"

注意事项

1. 必须在 async 函数中使用
2. 需要使用 await 关键字调用
3. 如果迭代器耗尽且未提供默认值，会抛出 StopAsyncIteration 异常
4. 在 Python 3.10 之前，可以通过 async_iterator.__anext__() 实现类似功能

应用场景

1. 异步数据流处理
2. 异步数据库查询结果遍历
3. 异步网络请求响应处理
4. 自定义异步生成器操作

与 next() 的区别

特性	anext	next
使用环境	异步上下文	同步上下文
异常类型	StopAsyncIteration	StopIteration
调用方式	需要 await	直接调用
适用对象	异步迭代器	同步迭代器

anext 的引入使 Python 的异步编程生态更加完整，为处理异步迭代提供了标准化的方法。