Archivo de encabezado de la biblioteca estándar <coroutine>
De cppreference.com
Este archivo de encabezado es parte de la biblioteca de soporte de corrutinas.
Incluye a | ||
(C++20) |
Apoyo para el operador de comparación de tres vías. | |
Clases | ||
(C++20) |
Rasgo de tipo para descubrir tipos de promesas de corrutinas (plantilla de clase) | |
(C++20) |
Usado para referirse a una corrutina suspendida o en ejecución (plantilla de clase) | |
Soporte hash (resumen) para un identificador de corrutina (std::coroutine_handle) (especialización de plantilla de clase) | ||
Corrutinas no operativas | ||
(C++20) |
Usado para corrutinas que no tienen efectos observables (clase) | |
(C++20) |
std::coroutine_handle<std::noop_coroutine_promise>, destinado a referirse a una corrutina no operativa (typedef) | |
En espera triviales | ||
(C++20) |
Indica que una expresión de espera nunca deberá suspender (clase) | |
(C++20) |
Indica que una expresión de espera siempre deberá suspender (clase) | |
Funciones | ||
(C++20) |
Compara dos objetos identificadores de corrutinas (coroutine_handle ) (función) | |
coroutine_handle/dsc hash | ||
Corrutinas no operativas | ||
(C++20) |
Crea un identificador de corrutina que no tiene efectos observables cuando se reanuda o destruye (función) |
[editar] Sinopsis
#include <compare> namespace std { // rasgos de corrutinas template<class R, class... ArgTypes> struct coroutine_traits; // identificador de corrutina template<class Promise = void> struct coroutine_handle; // operadores de comparación constexpr bool operator==(coroutine_handle<> x, coroutine_handle<> y) noexcept; constexpr strong_ordering operator<=>(coroutine_handle<> x, coroutine_handle<> y) noexcept; // soporte para hash (resumen) template<class T> struct hash; template<class P> struct hash<coroutine_handle<P>>; // corrutinas no operativas struct noop_coroutine_promise; template<> struct coroutine_handle<noop_coroutine_promise>; using noop_coroutine_handle = coroutine_handle<noop_coroutine_promise>; noop_coroutine_handle noop_coroutine() noexcept; // en espera triviales struct suspend_never; struct suspend_always; }
[editar] Plantilla de clase std::coroutine_handle
namespace std { template<> struct coroutine_handle<void> { // construir/restablecer constexpr coroutine_handle() noexcept; constexpr coroutine_handle(nullptr_t) noexcept; coroutine_handle& operator=(nullptr_t) noexcept; // exportar/importar constexpr void* address() const noexcept; static constexpr coroutine_handle from_address(void* addr); // observadores constexpr explicit operator bool() const noexcept; bool done() const; // reanudación void operator()() const; void resume() const; void destroy() const; private: void* ptr; // solo exposición }; template<class Promise> struct coroutine_handle : coroutine_handle<> { // construir/restablecer using coroutine_handle<>::coroutine_handle; static coroutine_handle from_promise(Promise&); coroutine_handle& operator=(nullptr_t) noexcept; // exportar/importar static constexpr coroutine_handle from_address(void* addr); // accesso a promesa Promise& promise() const; }; }
[editar] Clase std::noop_coroutine_promise
namespace std { struct noop_coroutine_promise {}; }
[editar] Clase std::coroutine_handle<std::noop_coroutine_promise>
namespace std { template<> struct coroutine_handle<noop_coroutine_promise> : coroutine_handle<> { // observadores constexpr explicit operator bool() const noexcept; constexpr bool done() const noexcept; // reanudación constexpr void operator()() const noexcept; constexpr void resume() const noexcept; constexpr void destroy() const noexcept; // acceso a promesa noop_coroutine_promise& promise() const noexcept; // dirección constexpr void* address() const noexcept; private: coroutine_handle(/* sin especificar */); }; }
[editar] Clase std::suspend_never
namespace std { struct suspend_never { constexpr bool await_ready() const noexcept { return true; } constexpr void await_suspend(coroutine_handle<>) const noexcept {} constexpr void await_resume() const noexcept {} }; }
[editar] Clase std::suspend_always
namespace std { struct suspend_always { constexpr bool await_ready() const noexcept { return false; } constexpr void await_suspend(coroutine_handle<>) const noexcept {} constexpr void await_resume() const noexcept {} }; }