anext() Próximo elemento assíncrono
Última atualização: 2026-09-22
anext() Próximo elemento assíncrono
anext(async_iterator[, default]) retorna o próximo item de um iterador assíncrono.
| Categoria | Funções internas |
|---|---|
| Tipo | Função interna |
| Versão do Python | 3.10+ |
📝 Sintaxe
anext(async_iterator[, default])⚙️ Parâmetros
| async_iterator Obrigatório | An async iterator. |
|---|---|
| default Opcional | Value returned when the async iterator is exhausted and no fallback is given. |
Retorno：The next item from the async iterator; returns default if exhausted and default is given.
💥 Exceções
StopAsyncIteration— Raised when the async iterator is exhausted and no default is given.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
1
2
end🏷️ Funções internas relacionadas
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQual é a diferença entre anext(it) e next(it)?
Anext() é síncrono e retorna o próximo item diretamente; anext() trabalha com iteradores assíncronos, cujo __anext__() retorna uma corrotina que precisa ser aguardada: await anext(it). O pareamento segue iter↔next e aiter↔anext.
QO que acontece quando o iterador assíncrono termina?
ALevanta StopAsyncIteration quando nenhum default é fornecido; se o segundo parâmetro default for passado (ex.: anext(it, 0)), retorna default em vez de levantar.
Qanext precisa ser usado em um contexto async?
AEm essência, sim. __anext__() retorna uma corrotina, então normalmente você aguarda dentro de uma função async; o async for chama automaticamente. A função pode ser chamada em qualquer lugar, mas o valor retornado precisa ser aguardado.
QComo obter itens com segurança sem usar default?
AEnvolva await anext(it) em try/except StopAsyncIteration; ou, mais simples, itere diretamente com async for, que trata o esgotamento internamente.
