std::execution::just_error

 

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>
inline constexpr just_error_t just_error{}; struct just_error_t { /*nicht spezifiziert*/ };		(seit C++26) (Customization-Point-Objekt)
Aufruf-Signatur
execution::sender auto just_error( auto&& error );		(seit C++26)

Ein Sender-Factory, die einen Sender zurückgibt, der sofort durch Aufrufen von set_error() des Empfängers abschließt.

Sei e ein Teilausdruck, der durch einen Eingabefehler repräsentiert wird, der in den Empfänger injiziert und von diesem zurückgegeben wird. Der Ausdruck just_error(e) ist ausdrucksäquivalent zu /*make-sender*/(just_error, /*product-type*/(e))

Customization Point Objects

Der Name execution::just_error bezeichnet ein Customization Point Object, ein konstantes Funktionsobjekt eines literalen semiregular-Klassentyps. Die cv-unqualifizierte Version seines Typs ist ein Tag-Typ, der als execution::just_error_t bezeichnet wird.

Alle Instanzen von execution::just_error_t sind gleich. Die Auswirkungen des Aufrufs verschiedener Instanzen des Typs execution::just_error_t mit denselben Argumenten sind äquivalent, unabhängig davon, ob der die Instanz bezeichnende Ausdruck ein lvalue oder rvalue ist und ob er const-qualifiziert ist oder nicht (eine volatile-qualifizierte Instanz muss jedoch nicht aufrufbar sein). Daher kann execution::just_error frei kopiert und seine Kopien können austauschbar verwendet werden.

Gegeben sei eine Menge von Typen Args..., wenn std::declval<Args>()... die obigen Anforderungen für Argumente von execution::just_error erfüllen, dann modelliert execution::just_error_t

• std::invocable<execution::just_error_t, Args...>,
• std::invocable<const execution::just_error_t, Args...>,
• std::invocable<execution::just_error_t&, Args...>, und
• std::invocable<const execution::just_error_t&, Args...>.
  

Andernfalls nimmt kein Funktionsoperator von execution::just_error_t an der Überladungsauflösung teil.

Anmerkungen

Wenn der bereitgestellte Fehler eine lvalue-Referenz ist, wird eine Kopie innerhalb des zurückgegebenen Senders erstellt und eine non-const lvalue-Referenz auf die Kopie an die set_error des Empfängers gesendet. Wenn der bereitgestellte Wert eine rvalue-Referenz ist, wird er in den zurückgegebenen Sender verschoben und eine rvalue-Referenz darauf an die set_error des Empfängers gesendet.