Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::stop_token — kooperativno zaustavljanje operacija

std::stop_token omogućuje operaciji da provjeri je li upućen zahtjev za zaustavljanje. stop_requested() čita zajedničko stanje; sam token ne zaustavlja dretvu niti upućuje zahtjev.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

#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 iz zaglavlja <stop_token> podržava kooperativno zaustavljanje operacija. std::stop_source pruža token putem get_token() i upućuje zahtjev putem request_stop(). Kopije tokena dijele stanje zaustavljanja, ako ono postoji. Kod operacije mora sam reagirati na zahtjev; ne radi se o prisilnom prekidu dretve.

std::stop_token::stop_requested() ima potpis bool stop_requested() const noexcept;. Vraća true kada povezano stanje primi zahtjev za zaustavljanje, a inače false. Zahtjev se ne može povući. Vrijednost false ne jamči da zahtjev neće stići odmah nakon toga.

stop_possible() odgovara na drugo pitanje: vraća false ako token nema stanje ili ako nije upućen nijedan zahtjev i više ne postoji povezani std::stop_source. U ostalim slučajevima vraća true, čak i nakon upućenog zahtjeva. Za token stvoren prema zadanim postavkama obje metode vraćaju false.

Primjer namjerno ne stvara dretve, pa je njegov izlaz deterministički. Prikazuje prazan token i povezani token prije zahtjeva i nakon njega. Ovaj se unos odnosi na C++23; priloženi radni nacrt dokument je koji se dalje razvija, a ne zamrznuto izdanje C++23.

Primjeri

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

Rezultat

false false
true false
true true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori