boost::capy::this_coro

Namespace for coroutine environment accessors.

Description

The this_coro namespace contains tag objects that can be awaited to retrieve information about the current coroutine's execution context. These tags are intercepted by a promise type's await_transform to yield the appropriate values without suspending.

Example

task<void> example()
{
    auto const& env = co_await this_coro::environment;
    auto ex = co_await this_coro::executor;
    auto token = co_await this_coro::stop_token;
    auto* alloc = co_await this_coro::allocator;
}