std::coroutine_handle<Promise>::operator(), std::coroutine_handle<Promise>::resume

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dienstprogramm-Bibliotheken

Sprachunterstützung Typunterstützung (Basistypen, RTTI) Bibliotheks-Feature-Test-Makros (C++20) Programm-Dienstprogramme Variadische Funktionen initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Coroutine-Unterstützung (C++20) Vertragsunterstützung (C++26) Drei-Wege-Vergleich three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Allgemeine Hilfsmittel Funktionsobjekte Bit-Manipulation (C++20) bitset hash (C++11) Relationale Operatoren (in C++20 veraltet) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Ganzzahl-Vergleichsfunktionen cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap und Typ-Operationen swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Gemeinsame Vokabulartypen pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Coroutine support

Coroutine traits

coroutine_traits (C++20)

Coroutine handle

coroutine_handle (C++20)

No-op coroutines

noop_coroutine_promise (C++20)

noop_coroutine (C++20)

Trivial awaitables

suspend_never (C++20)

suspend_always (C++20)

Range generators

generator (C++23)

 

std::coroutine_handle

Memberfunktionen

coroutine_handle::coroutine_handle

coroutine_handle::operator=

coroutine_handle::from_promise

Konversion

coroutine_handle::operator coroutine_handle<>

Observer

coroutine_handle::done

coroutine_handle::operator bool

Steuerung

coroutine_handle::operator()coroutine_handle::resume

coroutine_handle::destroy

Zugriff auf Promise

coroutine_handle::promise

Export/Import

coroutine_handle::address

coroutine_handle::from_address

Nicht-Member-Funktionen

operator==operator<=>

Hilfsklassen

hash<std::coroutine_handle>

 

Mitglied anderer Spezialisierungen
void operator()() const; void resume() const;	(1)	(seit C++20)
Mitglied der Spezialisierung std::coroutine_handle<std::noop_coroutine_promise>
constexpr void operator()() const noexcept; constexpr void resume() const noexcept;	(2)	(seit C++20)

1) Setzt die Ausführung des Coroutinen, auf das *this verweist, fort, oder tut nichts, wenn die Coroutine eine No-Op-Coroutine ist.

2) Tut nichts.

Das Verhalten ist undefiniert, wenn *this nicht auf eine suspendierte Coroutine verweist oder die Coroutine keine No-Op-Coroutine ist und an ihrem finalen Suspendpunkt suspendiert wurde. Eine gleichzeitige Wiederaufnahme der Coroutine kann zu einem Datenrennen führen.

Die Wiederaufnahme einer Coroutine auf einem anderen Ausführungsagenten als dem, auf dem sie suspendiert wurde, hat implementierungsabhängiges Verhalten, es sei denn, jeder Ausführungsagent ist entweder ein Thread, der durch std::thread oder std::jthread dargestellt wird, oder ist der Thread, der main ausführt.

Parameter

(keine)

Rückgabewert

(keine)

Ausnahmen

Wenn eine Ausnahme aus der Ausführung der Coroutine geworfen wird, wird die Ausnahme abgefangen und unhandled_exception für das Promise-Objekt der Coroutine aufgerufen. Wenn der Aufruf von unhandled_exception eine Ausnahme wirft oder erneut wirft, wird diese Ausnahme weitergegeben.

Hinweise

Eine Coroutine, die auf einem anderen Ausführungsagenten wiederaufgenommen wird, sollte es vermeiden, sich durchgehend auf eine konsistente Thread-Identität zu verlassen, z. B. das Halten eines Mutex-Objekts über einen Suspendpunkt hinaus.

Siehe auch

destroy

zerstört eine Coroutine (öffentliche Memberfunktion)