Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::stop_token::stop_requested — provjera zahtjeva za zaustavljanje

Provjeri je li zajedničko stanje zaustavljanja primilo zahtjev kako bi posao mogao završiti na sigurnom mjestu. Rezultat `true` ne znači da je dretva već završila.

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

Sintaksa

bool stop_requested() const noexcept;

std::stop_token::stop_requested je funkcija članica iz zaglavlja <stop_token>, uvedena u C++20 i dostupna u C++23. Poziv token.stop_requested() ne prima argumente, a funkcija je const noexcept. Vraća true samo ako je pridruženo stanje zaustavljanja primilo zahtjev za zaustavljanje. Inače vraća false, pa tako i za token stvoren zadanim konstruktorom, koji nema pridruženo stanje.

std::stop_source::get_token() vraća token koji s izvorom dijeli stanje zaustavljanja, a ne kopiju trenutačne vrijednosti zastavice. Token održava to stanje na životu, pa uništavanje izvora ne briše zabilježeni zahtjev. token.stop_possible() odgovara na drugo pitanje: vraća true ako je zahtjev već podnesen ili još postoji pridruženi izvor koji ga može podnijeti.

std::stop_source::request_stop() podnosi zahtjev i vraća true samo kada zabilježi prvi zahtjev za to stanje. Vraća false ako je zahtjev već podnesen ili ako izvor nema stanje. Zahtjev se ne može povući. std::jthread::request_stop() djeluje na interni izvor objekta std::jthread; token dobiven pozivom get_stop_token() promatra isto stanje.

Otkazivanje je kooperativno: provjeravaj token između pojedinih dijelova posla i završi na sigurnom mjestu. true označava zahtjev, a ne završetak dretve. Sam zahtjev ne prekida proizvoljnu blokirajuću operaciju.

Primjeri

#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';
}

Rezultat

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

Program ne pokreće dretve. Prvi se zahtjev bilježi, a drugi ništa ne mijenja. Token i nakon uništavanja izvora vidi zahtjev; prazan token vraća `false`.

Povezane lekcije

  • C++ · Lekcija 39 · Napredno · Verzija: 3
  • C++ · Lekcija 44 · Napredno · Verzija: 3

Izvori