Archivo de encabezado de la biblioteca estándar <coroutine>

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Archivos de encabezado de la biblioteca estándar

Apoyo del lenguaje <cfloat> <climits> <compare>(C++20) <coroutine>(C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint>(C++11) <cstdlib> <exception> <initializer_list>(C++11)    <limits> <new> <source_location>(C++20) <stdfloat>(C++23) <typeinfo> <version>(C++20) Conceptos <concepts>(C++20) Diagnósticos <cassert> <cerrno> <debugging>(C++26) <stacktrace>(C++23) <stdexcept> <system_error>(C++11) Gestión de memoria <memory> <memory_resource>(C++17) <scoped_allocator>(C++11) Metaprogramación <type_traits>(C++11) <ratio>(C++11)

Servicios generales <any>(C++17) <bitset> <bit>(C++20) <charconv>(C++17) <expected>(C++23) <format>(C++20) <functional> <optional>(C++17) <tuple>(C++11) <typeindex>(C++11) <utility> <variant>(C++17) Contenedores <array>(C++11) <deque> <flat_map>(C++23) <flat_set>(C++23) <forward_list>(C++11) <inplace_vector>(C++26)    <list> <map> <mdspan>(C++23) <queue> <set> <span>(C++20) <stack> <unordered_map>(C++11) <unordered_set>(C++11) <vector> Iteradores <iterator> Rangos <generator>(C++23) <ranges>(C++20)

Algoritmos <algorithm> <numeric> Cadenas <cctype> <cstring> <cuchar>(C++11) <cwchar> <cwctype> <string_view>(C++17) <string> Procesamiento de texto <clocale> <codecvt>(C++11/17/26*) <locale> <regex>(C++11) <text_encoding>(C++26)    Numéricos <cfenv>(C++11) <cmath> <complex> <linalg>(C++26) <numbers>(C++20) <random>(C++11) <simd>(C++26) <valarray> Tiempo <chrono>(C++11) <ctime> Compatibilidad con C <ccomplex>(C++11/17/20*) <ciso646>(hasta C++20) <cstdalign>(C++11/17/20*) <cstdbool>(C++11/17/20*) <ctgmath>(C++11/17/20*)

Entrada/Salida <cinttypes>(C++11) <cstdio> <filesystem>(C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print>(C++23) <spanstream>(C++23) <sstream> <streambuf> <strstream>(C++98/26*) <syncstream>(C++20) Apoyo para concurrencia <atomic>(C++11) <barrier>(C++20) <condition_variable>(C++11) <future>(C++11) <hazard_pointer>(C++26) <latch>(C++20) <mutex>(C++11) <rcu>(C++26) <semaphore>(C++20) <shared_mutex>(C++14) <stdatomic.h>(C++23) <stop_token>(C++20) <thread>(C++11) Apoyo de ejecución <execution>(C++17)

 

Este archivo de encabezado es parte de la biblioteca de soporte de corrutinas.

Incluye a
<compare> (C++20)	Apoyo para el operador de comparación de tres vías.
Clases
coroutine_traits (C++20)	Rasgo de tipo para descubrir tipos de promesas de corrutinas (plantilla de clase)
coroutine_handle (C++20)	Usado para referirse a una corrutina suspendida o en ejecución (plantilla de clase)
std::hash<std::coroutine_handle> (C++20)	Soporte hash (resumen) para un identificador de corrutina (std::coroutine_handle) (especialización de plantilla de clase)
Corrutinas no operativas
noop_coroutine_promise (C++20)	Usado para corrutinas que no tienen efectos observables (clase)
noop_coroutine_handle (C++20)	std::coroutine_handle<std::noop_coroutine_promise>, destinado a referirse a una corrutina no operativa (typedef)
En espera triviales
suspend_never (C++20)	Indica que una expresión de espera nunca deberá suspender (clase)
suspend_always (C++20)	Indica que una expresión de espera siempre deberá suspender (clase)
Funciones
operator==operator<=> (C++20)	Compara dos objetos identificadores de corrutinas (coroutine_handle) (función)
coroutine_handle/dsc hash
Corrutinas no operativas
noop_coroutine (C++20)	Crea un identificador de corrutina que no tiene efectos observables cuando se reanuda o destruye (función)

Sinopsis

#include <compare>   namespace std {// rasgos de corrutinastemplate<class R, class... ArgTypes>struct coroutine_traits;   // identificador de corrutinatemplate<class Promise =void>struct coroutine_handle;   // operadores de comparaciónconstexprbool 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 operativasstruct 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 trivialesstruct suspend_never;struct suspend_always;}

Plantilla de clase std::coroutine_handle

namespace std {template<>struct coroutine_handle<void>{// construir/restablecerconstexpr coroutine_handle()noexcept;constexpr coroutine_handle(nullptr_t)noexcept; coroutine_handle& operator=(nullptr_t)noexcept;   // exportar/importarconstexprvoid* address()constnoexcept;staticconstexpr coroutine_handle from_address(void* addr);   // observadoresconstexprexplicit operator bool()constnoexcept;bool done()const;   // reanudaciónvoid operator()()const;void resume()const;void destroy()const;   private:void* ptr;// solo exposición};   template<class Promise>struct coroutine_handle : coroutine_handle<>{// construir/restablecerusing coroutine_handle<>::coroutine_handle;static coroutine_handle from_promise(Promise&); coroutine_handle& operator=(nullptr_t)noexcept;   // exportar/importarstaticconstexpr coroutine_handle from_address(void* addr);   // accesso a promesa Promise& promise()const;};}

Clase std::noop_coroutine_promise

namespace std {struct noop_coroutine_promise {};}

Clase std::coroutine_handle<std::noop_coroutine_promise>

namespace std {template<>struct coroutine_handle<noop_coroutine_promise>: coroutine_handle<>{// observadoresconstexprexplicit operator bool()constnoexcept;constexprbool done()constnoexcept;   // reanudaciónconstexprvoid operator()()constnoexcept;constexprvoid resume()constnoexcept;constexprvoid destroy()constnoexcept;   // acceso a promesa noop_coroutine_promise& promise()constnoexcept;   // direcciónconstexprvoid* address()constnoexcept;private: coroutine_handle(/* sin especificar */);};}

Clase std::suspend_never

namespace std {struct suspend_never {constexprbool await_ready()constnoexcept{returntrue;}constexprvoid await_suspend(coroutine_handle<>)constnoexcept{}constexprvoid await_resume()constnoexcept{}};}

Clase std::suspend_always

namespace std {struct suspend_always {constexprbool await_ready()constnoexcept{returnfalse;}constexprvoid await_suspend(coroutine_handle<>)constnoexcept{}constexprvoid await_resume()constnoexcept{}};}