Python 的內置函數 anext 是 Python 3.10 版本新增的一個異步迭代器操作函數，專門用於異步獲取迭代器的下一個值。它是同步環境中的 next() 函數的異步版本，用於處理異步迭代器（asynchronous iterator）。

函數定義

async def anext(iterator, default=None)

參數説明

• iterator: 必須是一個異步迭代器對象（實現了 __aiter__ 和 __anext__ 方法的對象）
• default: 可選參數，當迭代器耗盡時返回的默認值。如果不提供且迭代器已耗盡，會拋出 StopAsyncIteration 異常

使用示例

1. 基本用法：

   async def async_gen():
    yield 1
    yield 2
   
   async def main():
    ag = async_gen()
    print(await anext(ag))  # 輸出 1
    print(await anext(ag))  # 輸出 2
    print(await anext(ag, "end"))  # 輸出 "end"

2. 與異步生成器配合使用：

   async def countdown(n):
    while n > 0:
        yield n
        n -= 1
        await asyncio.sleep(1)
   
   async def main():
    async for number in countdown(3):
        print(number)
    # 等價於
    cd = countdown(3)
    while True:
        try:
            print(await anext(cd))
        except StopAsyncIteration:
            break

注意事項

1. 必須用在 async 函數中，且需要使用 await 關鍵字
2. 如果迭代器不是異步迭代器，會拋出 TypeError
3. 在沒有默認值且迭代器耗盡時，會拋出 StopAsyncIteration 異常
4. 在 Python 3.10 之前的版本中，可以通過 await iterator.__anext__() 實現類似功能

應用場景

1. 處理異步數據流（如網絡請求響應）
2. 實現自定義異步迭代器
3. 在異步環境中逐步處理大量數據

與 next() 的區別

這個函數簡化了異步迭代器的操作，使得異步編程更加直觀和方便。