std::noop_c...tine_promise(3)

okay bestie, welcome to the std::noop_c...tine_promise(3) page from the C++ Standard Libary — it's giving deep coroutine lore, but make it cute 💅✨

✨ NAME ✨

• std::noop_coroutine_promise — literally std::noop_coroutine_promise, the promise type of no-op coroutines. Periodt.

🦋 Synopsis 🦋

okay so here's the declaration vibe, defined in header <coroutine>:

Defined in header <coroutine>
struct noop_coroutine_promise {};  (since C++20)

noop_coroutine_promise is the promise type of no-op coroutines.

A no-op coroutine behaves as if it:

• does nothing other than the control flow of a coroutine, and
• is suspended immediately after beginning and resumption, and
• has a coroutine state such that destroying the state is no-op, and
• never reaches its final suspended point if there is any std::coroutine_handle referring to it.

This section is incomplete — Reason: more precise wording

No-op coroutines can be started by std::noop_coroutine, and controlled by the coroutine handle it returns. The returned coroutine handle is of type std::noop_coroutine_handle, which is a synonym for std::coroutine_handle<std::noop_coroutine_promise>.

Some operations of no-op coroutines are determined no-op at compile time through the type std::noop_coroutine_handle.

This section is incomplete — Reason: usage of no-op coroutines

🎀 Example 🎀

This section is incomplete — Reason: no example

👑 See also 👑

• noop_coroutine (C++20) — creates a coroutine handle that has no observable effects when resumed or destroyed. (function)
• noop_coroutine_handle (C++20) — std::coroutine_handle<std::noop_coroutine_promise>, intended to refer to a no-op coroutine. (typedef)

🏷️ Categories

• Todo with reason
• Todo no example

mwah 💋 — source/version: http://cppreference.com, date: 2024.06.10.