aiter() Async iterator
Last updated: 2026-09-22
aiter() Async iterator
aiter(async_iterable) returns an async iterator for an async iterable.
| Category | Built-in Functions |
|---|---|
| Kind | Built-in Function |
| Python Version | 3.10+ |
📝 Syntax
aiter(async_iterable)⚙️ Parameters
| iterable Required | An async iterable. |
|---|
Returns：An async iterator for the async iterable.
💥 Raises
TypeError— Raised when the object is not async-iterable (no __aiter__).
▶ Example
Edit the code, press Run, and see the result in the output panel:
Output：
1🏷️ Related Built-in Functions
💡 Related Cases
More case studies coming soon — check back later.
❓ FAQ
QWhat is the difference between aiter() and iter()?
Aaiter() is the async version, returning an async iterator (supporting __anext__) for async iterables, e.g. aiter(async_gen()).
QWhat is the relationship between async for and aiter()?
Aasync for internally combines aiter() + anext(), just as a synchronous for uses iter() + next().
QWhat happens when aiter() is called on an ordinary list?
AIt raises a TypeError — a list has no __aiter__ method and is not an async iterable; to iterate asynchronously use an async generator or a third-party async container.
QMust aiter() only be called in an async context?
AThe call itself is not enforced, but the resulting async iterator can only be consumed in async code (await anext or async for).
