Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::stop_token — kooperacyjne zatrzymywanie operacji

std::stop_token pozwala operacji sprawdzać, czy zgłoszono żądanie zatrzymania. Metoda stop_requested() odczytuje współdzielony stan; sam token nie zatrzymuje wątku ani nie wysyła żądania.

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 requested = token.stop_requested();
// Member signature: bool stop_requested() const noexcept;

std::stop_token z nagłówka <stop_token> służy do kooperacyjnego zatrzymywania operacji. Obiekt std::stop_source udostępnia token przez get_token() i zgłasza żądanie przez request_stop(). Kopie tokena współdzielą stan zatrzymania, jeśli taki istnieje. Kod operacji musi sam zareagować na żądanie; nie jest to wymuszone przerwanie wątku.

std::stop_token::stop_requested() ma sygnaturę bool stop_requested() const noexcept;. Zwraca true, gdy powiązany stan otrzymał żądanie zatrzymania, a w przeciwnym razie false. Żądania nie można wycofać. Odczyt false nie gwarantuje, że żądanie nie pojawi się chwilę później.

stop_possible() odpowiada na inne pytanie: zwraca false, gdy token nie ma stanu albo gdy nie zgłoszono żądania i nie pozostał żaden powiązany std::stop_source. W pozostałych przypadkach zwraca true, także po zgłoszeniu żądania. Dla domyślnie utworzonego tokena obie metody zwracają false.

Przykład celowo nie tworzy wątków, więc wynik jest deterministyczny. Pokazuje pusty token oraz token przed żądaniem i po nim. Zakres wpisu to C++23; podany projekt standardu jest dokumentem rozwijanym, a nie zamrożonym wydaniem C++23.

Przykłady

#include <iostream>
#include <stop_token>

int main() {
    std::stop_source source;
    std::stop_token token = source.get_token();
    std::stop_token empty;

    std::cout << std::boolalpha;
    std::cout << empty.stop_possible() << ' '
              << empty.stop_requested() << '\n';
    std::cout << token.stop_possible() << ' '
              << token.stop_requested() << '\n';
    source.request_stop();
    std::cout << token.stop_possible() << ' '
              << token.stop_requested() << '\n';
}

Wynik

false false
true false
true true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła