CKTIS / C++
std::stop_source — źródło żądania zatrzymania
std::stop_source udostępnia wspólny stan żądania zatrzymania. get_token() pozwala go obserwować, a request_stop() zgłasza żądanie. Jest to mechanizm kooperacyjny: nie przerywa automatycznie wykonywania wątku.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <stop_token>
std::stop_source source;
std::stop_token token = source.get_token();
bool first_request = source.request_stop();
// Member signatures:
// std::stop_token get_token() const noexcept;
// bool request_stop() noexcept;std::stop_source z nagłówka <stop_token> służy do kooperacyjnego zatrzymywania pracy. Domyślna konstrukcja tworzy nowy stan bez żądania zatrzymania; kopie źródła współdzielą stan. Kod wykonujący pracę musi sprawdzać token lub korzystać z mechanizmu reagującego na żądanie. Samo źródło nie uruchamia ani nie kończy wątku.
std::stop_source::get_token() ma sygnaturę std::stop_token get_token() const noexcept. Zwraca token powiązany ze stanem źródła; token pozwala obserwować żądanie przez stop_requested(), ale nie pozwala go zgłosić. Źródło utworzone jako std::stop_source{std::nostopstate} nie ma stanu: get_token() zwraca wtedy pusty token, a request_stop() zwraca false.
std::stop_source::request_stop() ma sygnaturę bool request_stop() noexcept. Atomowo zgłasza pierwsze żądanie dla wspólnego stanu i zwraca true tylko wywołaniu, które je zgłosiło. Kolejne wywołania zwracają false; nie oznacza to błędu ani potwierdzenia zakończenia pracy. Żądania nie można cofnąć — nowy cykl wymaga nowego stanu.
Zarejestrowane wywołania zwrotne są wykonywane synchronicznie przy pierwszym żądaniu, więc request_stop() może wykonywać kod użytkownika przed powrotem. Wyjątek opuszczający takie wywołanie powoduje std::terminate. Przykład celowo nie tworzy wątków: pokazuje deterministycznie zmianę stanu widoczną przez token.
Przykłady
#include <iostream>
#include <stop_token>
int main() {
std::stop_source source;
const std::stop_token token = source.get_token();
std::cout << std::boolalpha;
std::cout << "before: " << token.stop_requested() << '\n';
const bool first = source.request_stop();
const bool second = source.request_stop();
std::cout << "requests: " << first << ' ' << second << '\n';
std::cout << "after: " << token.stop_requested() << '\n';
}
Wynik
before: false requests: true false after: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.