Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::stop_token::stop_requested — sprawdzanie żądania zatrzymania

Sprawdź, czy współdzielony stan zatrzymania otrzymał żądanie, i zdecyduj, kiedy zakończyć pracę. Wynik `true` nie oznacza, że wątek już się zakończył.

Wersja: ISO C++23; implementation support may vary

Składnia

bool stop_requested() const noexcept;

std::stop_token::stop_requested to funkcja składowa z nagłówka <stop_token>, dostępna od C++20 i obecna w C++23. Wywołanie token.stop_requested() nie przyjmuje argumentów, jest const noexcept i zwraca true tylko wtedy, gdy powiązany stan otrzymał żądanie zatrzymania. W przeciwnym razie zwraca false, także dla tokenu skonstruowanego domyślnie, który nie ma stanu.

std::stop_source::get_token() zwraca token współdzielący stan źródła, a nie kopię bieżącej wartości flagi. Token podtrzymuje istnienie tego stanu, więc zniszczenie źródła nie kasuje zarejestrowanego żądania. token.stop_possible() odpowiada na inne pytanie: zwraca true, gdy żądanie już zgłoszono lub nadal istnieje powiązane źródło, które może je zgłosić.

std::stop_source::request_stop() zgłasza żądanie i zwraca true tylko wtedy, gdy rejestruje pierwsze żądanie dla danego stanu. Kolejne wywołanie zwraca false, tak samo jak wywołanie na źródle bez stanu. Żądania nie można cofnąć. std::jthread::request_stop() działa na wewnętrznym źródle danego obiektu std::jthread; token z get_stop_token() obserwuje ten sam stan.

To mechanizm współpracy: sprawdzaj token między porcjami pracy i zakończ ją w bezpiecznym miejscu. true sygnalizuje żądanie, a nie zakończenie wątku. Samo żądanie nie przerywa dowolnej operacji blokującej.

Przykłady

#include <iostream>
#include <stop_token>

int main() {
    std::stop_token token;
    std::cout << std::boolalpha;

    {
        std::stop_source source;
        token = source.get_token();
        std::cout << "Before request: " << token.stop_requested() << '\n';
        std::cout << "First request: " << source.request_stop() << '\n';
        std::cout << "Repeated request: " << source.request_stop() << '\n';
    }

    std::cout << "After source destruction: " << token.stop_requested() << '\n';
    std::cout << "Empty token: " << std::stop_token{}.stop_requested() << '\n';
}

Wynik

Before request: false
First request: true
Repeated request: false
After source destruction: true
Empty token: false

Program nie uruchamia wątków. Pierwsze żądanie zostaje zarejestrowane, a drugie niczego nie zmienia. Token nadal widzi żądanie po zniszczeniu źródła; pusty token zwraca `false`.

Powiązane lekcje

  • C++ · Lekcja 39 · Zaawansowany · Wersja: 3
  • C++ · Lekcja 44 · Zaawansowany · Wersja: 3

Źródła