std::execution::ensure_started

 

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

 

Bibliothek für Ausführungssteuerung

Konzepte der Ausführung scheduler receiver receiver_of operation_state    sender sender_in sender_to Komponenten der Ausführung Ausführungskontexte run_loop Ausführungsdomänen default_domain Forward-Progress-Garantie forward_progress_guarantee Umgebungen empty_env    get_env    env_of_t Abfragen std::stop_token_of_t std::get_stop_token std::get_allocator std::forwarding_query get_scheduler get_domain get_forward_progress_guarantee get_delegation_scheduler get_completion_scheduler Abschluss-Signaturen completion_signatures completion_signatures_of_t transform_completion_signatures transform_completion_signatures_of    value_types_of_t error_types_of_t    tag_of_t sends_stopped    Sender-Adaptor-Closures sender_adaptor_closure Coroutine-Hilfsmittel as_awaitable with_awaitable_senders

Kernoperationen Operationszustand connect connect_result_t start Abschluss set_value set_error set_stopped Transformation transform_env transform_sender apply_sender Sender-Algorithmen Sender-Fabriken just just_error just_stopped read_env schedule schedule_result_t Sender-Adaptoren starts_on continues_on    on then upon_error upon_stopped let_value let_error let_stopped schedule_from when_all when_all_with_variant into_variant stopped_as_optional stopped_as_error bulk split Sender-Konsumenten this_thread::sync_wait this_thread::sync_wait_with_variant

 

Definiert in Header <execution>
execution::sender auto ensure_started( execution::sender auto sender );		(seit C++26)

Parameter

sender

-

Eingabe-Sender, dessen gestoppter Kanal in err abgebildet wird

Rückgabewert

Gibt einen Sender zurück, der abgeschlossen wird, wenn der bereitgestellte Sender abgeschlossen ist, und Werte sendet, die mit denen des bereitgestellten Senders äquivalent sind.

Hinweise

• Sobald ensure_started zurückgegeben wird, ist bekannt, dass der bereitgestellte Sender verbunden wurde und start für den resultierenden Operationszustand aufgerufen wurde. Mit anderen Worten, die durch den bereitgestellten Sender beschriebene Arbeit wurde zur Ausführung auf den entsprechenden Ausführungsressourcen übermittelt.

• Wenn der zurückgegebene Sender zerstört wird, bevor execution::connect() aufgerufen wird, oder wenn execution::connect() aufgerufen wird, aber der zurückgegebene Operationszustand zerstört wird, bevor execution::start() aufgerufen wird, dann wird eine Stopp-Anforderung an die eilig gestartete Operation gesendet und die Operation wird abgekoppelt und läuft im Hintergrund bis zum Abschluss.

• In diesem Fall wird das Ergebnis der Operation verworfen, wenn es schließlich abgeschlossen ist.

• Beachten Sie, dass die Anwendung sicherstellen muss, dass Ressourcen am Leben gehalten werden, falls die Operation abgekoppelt wird (z. B. durch Halten eines std::shared_ptr zu diesen Ressourcen).