Coroutine support (C++20) - cppreference.com (original) (raw)
Coroutine support
| Coroutine traits |
|---|
| coroutine_traits(C++20) |
| Coroutine handle |
| coroutine_handle(C++20) |
| No-op coroutines |
| noop_coroutine_promise(C++20) |
| noop_coroutine(C++20) |
| Trivial awaitables |
| suspend_never(C++20) |
| suspend_always(C++20) |
| Range generators |
| generator(C++23) |
The coroutine support library defines several types that provide compile and run-time support for coroutines.
Contents
[edit] Coroutine traits
| Defined in header | |
|---|---|
| coroutine_traits(C++20) | trait type for discovering coroutine promise types (class template) [edit] |
[edit] Coroutine handle
| Defined in header | |
|---|---|
| coroutine_handle(C++20) | used to refer to a suspended or executing coroutine (class template) [edit] |
[edit] No-op coroutines
| Defined in header | |
|---|---|
| noop_coroutine(C++20) | creates a coroutine handle that has no observable effects when resumed or destroyed (function) [edit] |
| noop_coroutine_promise(C++20) | used for coroutines with no observable effects (class) [edit] |
| noop_coroutine_handle(C++20) | std::coroutine_handle<std::noop_coroutine_promise>, intended to refer to a no-op coroutine (typedef) [edit] |
[edit] Trivial awaitables
| Defined in header | |
|---|---|
| suspend_never(C++20) | indicates that an await-expression should never suspend (class) [edit] |
| suspend_always(C++20) | indicates that an await-expression should always suspend (class) [edit] |
[edit] Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
| __cpp_lib_coroutine | 201902L | (C++20) | Coroutine support library |
[edit] See also
| generator(C++23) | A view that represents synchronous coroutine generator (class template) [edit] |
|---|