std::execution::just_error

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

執行控制庫

執行概念 排程器 接收器 receiver_of operation_state    傳送器 sender_in sender_to 執行元件 執行上下文 run_loop 執行域 default_domain 前進保證 forward_progress_guarantee 環境 empty_env    get_env    env_of_t 查詢 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 完成簽名 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_closure 協程工具 as_awaitable with_awaitable_senders

核心操作 操作狀態 connect connect_result_t start 完成 set_value set_error set_stopped 變換 transform_env transform_sender apply_sender 傳送器演算法 傳送器工廠 just just_error just_stopped read_env schedule schedule_result_t 傳送器介面卡 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 傳送器消費者 this_thread::sync_wait this_thread::sync_wait_with_variant

 

定義於標頭檔案 <execution>
inline constexpr just_error_t just_error{}; struct just_error_t { /*unspecified*/ };		(C++26 起) (定製點物件)
呼叫簽名 (Call signature)
execution::sender auto just_error( auto&& error );		(C++26 起)

一個 sender 工廠，它返回一個 sender，該 sender 透過呼叫 receiver 的 set_error() 立即完成。

令 e 為一個子表示式，它表示一個將被注入並由 receiver 返回的輸入錯誤。表示式 just_error(e) 表示式等價於 /*make-sender*/(just_error, /*product-type*/(e))

自定義點物件

名稱 execution::just_error 表示一個自定義點物件，它是一個 const 函式物件，屬於 字面量 semiregular 類型別。其 cv-unqualified 版本是一種標籤型別，表示為 execution::just_error_t。

execution::just_error_t 的所有例項均相等。在相同引數上呼叫型別 execution::just_error_t 的不同例項的效果是等價的，無論表示該例項的表示式是左值還是右值，以及是否為 const 限定（但是，volatile 限定的例項不要求可呼叫）。因此，execution::just_error 可以自由複製，並且其副本可以互換使用。

給定一組型別 Args...，如果 std::declval<Args>()... 滿足上述 execution::just_error 的引數要求，則 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...>，以及
• std::invocable<const execution::just_error_t&, Args...>.
  

否則，execution::just_error_t 的任何函式呼叫運算子都不參與過載決議。

注意

如果提供的錯誤是左值引用，則在返回的 sender 內部會進行一次複製，並將該複製的非 const 左值引用傳送到 receiver 的 set_error。如果提供的值是右值引用，它將被移動到返回的 sender 中，並將其右值引用傳送到 receiver 的 set_error。