std::execution::read(3)

💖 NAME 💖

std::execution::read - std::execution::read — okay bestie, this is the whole manpage vibe for std::execution::read from the C++ Standard Libary manual (manual name folded in near the top, as promised 🫶). It’s giving “reach into a receiver’s environment” energy, and we’re obsessed ✨.

📜 Synopsis 📜

Synopsis time, no cap:

Defined in header <execution>
execution::sender auto read( auto tag );  (since C++26)

🌸 Parameters 🌸

• tag — by which the customization point is recognized. That’s literally its whole job, iykyk 🎀.

🔥 Return value 🔥

Returns a sender 💫 — it reaches into a receiver’s environment and pulls out the current value associated with the customization point denoted by Tag. Capital-T Tag, keeping it iconic 👑.

✨ Example ✨

Possible usage of tags in read function, to retrieve the value associated with the customization point — here’s the whole flex, fr fr 💅:

execution::sender auto get_scheduler()
{
    return read(execution::get_scheduler);
}

execution::sender auto get_delegatee_scheduler()
{
    return read(execution::get_delegatee_scheduler);
}

execution::sender auto get_allocator()
{
    return read(execution::get_allocator);
}

execution::sender auto get_stop_token()
{
    return read(execution::get_stop_token);
}

okay that’s the whole page, bestie 🫶 — cute little sign-off time: source is http://cppreference.com, version/date is 2024.06.10, and this iconic manual page is std::execution::read(3). mwah 💋🌈