Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła