名稱空間
變體
操作

std::stop_source::request_stop

來自 cppreference.com
< cpp‎ | thread‎ | stop source
 
C++
 
併發支援庫
執行緒
(C++11)
(C++20)
(C++17)(C++17)
this_thread 名稱空間
(C++11)
(C++11)
(C++11)
(C++11)
協同取消
互斥
(C++11)
(C++11)
(C++17)
通用鎖管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
條件變數
(C++11)
(C++11)
(C++11)
(C++11)
訊號量
(C++20)(C++20)
門閂和屏障
(C++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
(C++26)
危險指標
(C++26)
(C++26)
(C++26)
原子型別
(C++11)
(C++20)
(C++11)
原子型別的初始化
(C++11)(C++20 中已棄用)
(C++11)(C++20 中已棄用)
(C++11)
記憶體排序
(C++11)
(C++11)(C++26 中已棄用)
(C++11)
(C++11)
原子操作的自由函式
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子標誌的自由函式
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::stop_source
 
bool request_stop() noexcept;
 (C++20 起)

向停止狀態（stop-state）發出停止請求，前提是 stop_source 物件擁有一個停止狀態，且該狀態尚未被請求停止。

這個決定是原子地做出的，如果請求了停止，停止狀態會原子地更新以避免競爭條件，這樣一來：

  • stop_requested() 和 stop_possible() 可以被其他共享同一停止狀態的 stop_token 和 stop_source 併發地呼叫；
  • request_stop() 可以被其他 stop_source 物件併發地呼叫，而只有一個會實際執行停止請求。

不過，請參閱“注意”一節。

目錄

[編輯] 引數

(無)

[編輯] 返回值

如果 stop_source 物件擁有一個停止狀態且本次呼叫發出了停止請求，則返回 true，否則返回 false。

[編輯] 後置條件

stop_possible() 為 false 或 stop_requested() 為 true。

[編輯] 注意

如果 request_stop() 確實發出了停止請求（即返回 true），那麼所有為同一關聯停止狀態註冊的 stop_callback 將會在呼叫 request_stop() 的同一執行緒上同步地被呼叫。如果某個回撥的呼叫因異常而退出，將會呼叫 std::terminate。

如果 stop_source 物件擁有一個停止狀態但已經發出了停止請求，那麼此函式返回 false。但是，不能保證另一個剛剛（成功）請求停止的 stop_source 物件沒有正在呼叫某個 stop_callback 函式的過程中。

如果 request_stop() 確實發出了停止請求（即返回 true），那麼所有與此 stop_source 的停止狀態相關聯的 stop_token 一起註冊了可中斷等待的、基型別為 std::condition_variable_any 的條件變數都將被通知。

[編輯] 示例

本節不完整
原因：無示例
來自“https://cppreference.tw/mwiki/index.php?title=cpp/thread/stop_source/request_stop&oldid=161265”