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