anext() Próximo item do iterador assíncrono
Última atualização: 2026-09-22
anext() Próximo item do iterador assíncrono
anext(awaitable) retorna o próximo item do awaitable; ao esgotar lança StopAsyncIteration.
| Categoria | Funções internas |
|---|---|
| Tipo | Função interna |
| Versão do Python | 3.10+ |
📝 Sintaxe
anext(awaitable[, default])⚙️ Parâmetros
| iterator Obrigatório | An async iterator. |
|---|---|
| default Opcional | Value returned on exhaustion, when provided.（Padrão：None） |
Retorno：The next item of the async iterator, or default if exhausted.
💥 Exceções
StopAsyncIteration— Raised when exhausted with no default.TypeError— Raised when the argument is not an async iterator.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
1
2🏷️ Funções internas relacionadas
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQual é a diferença entre anext() e next()?
Aanext() é a versão assíncrona de next(), para iteradores assíncronos; deve ser chamado como await anext(it) e apenas dentro de uma função async.
QO que acontece quando anext(it) se esgota?
ALevanta StopAsyncIteration; passar o argumento default retorna esse valor em vez de levantar, com o mesmo mecanismo de next().
QUm iterador comum pode ser passado a anext()?
ANão — levanta TypeError; anext() só aceita iteradores assíncronos (objetos que implementam __anext__).
QEm que cenário usar anext()?
AAo consumir manualmente um gerador assíncrono ou iterador assíncrono, ex.: await anext(it) para obter o próximo valor — a contraparte assíncrona de next() no código síncrono.
