CKTIS / C++
std::jthread — samodejna pridružitev in sodelovalna zaustavitev
std::jthread upravlja nit in ob uničenju objekta, ki ga je še mogoče pridružiti, zahteva zaustavitev, nato pa počaka na zaključek. std::jthread::request_stop izvajanja ne prekine na silo: nit mora sodelovati, na primer s preverjanjem std::stop_token.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <thread>
#include <stop_token>
std::jthread worker([](std::stop_token token) {
// Cooperatively observe token.stop_requested().
});
bool first_request = worker.request_stop();std::jthread iz glave <thread> je premakljiv, nekopirljiv lastnik niti. Konstruktor preveri veljavnost klica na podlagi tipov klicljivega objekta in argumentov po pretvorbi z std::decay_t, ne na podlagi prvotno podanih izrazov. Če je vrednost std::is_invocable_v<std::decay_t<F>, std::stop_token, std::decay_t<Args>...> enaka true (pri čemer sta F in Args... izpeljani tip klicljivega objekta in izpeljani tipi argumentov), konstruktor izbere klic s std::stop_token kot prvim argumentom. Sicer izbere klic brez žetona, ki mora biti veljaven za iste pretvorjene tipe. Že samo prejemanje žetona še ne zagotavlja podpore za zaustavitev.
std::jthread::request_stop() ima podpis bool request_stop() noexcept. Vrne true, ko ta klic prvič zabeleži zahtevo v skupnem stanju zaustavitve; poznejše zahteve vrnejo false. Če stanja zaustavitve ni, prav tako vrne false. Rezultat ne potrjuje, da je nit končana. Registrirane povratne funkcije za zaustavitev se med prvo uspešno zahtevo izvedejo sinhrono.
Če joinable() vrne true, destruktor pokliče request_stop() in nato join(). Za razliko od std::thread zato pred običajnim izhodom iz dosega ni potrebna ročna pridružitev. Vendar to ni prisilna prekinitev: ignoriranje žetona ali zadrževanje v blokirajoči operaciji lahko zaključek odloži za nedoločen čas. Zajeti sklici morajo ostati veljavni, dokler se nit ne konča.
V primeru prva zahteva vrne true, druga pa false. Destruktor počaka, da se nit konča, preden se prebere observed, zato ta navadni bool tukaj ne potrebuje atomskih operacij. Zanka z yield() je le kratka ponazoritev aktivnega čakanja, ne pa učinkovit vzorec čakanja. Način repozitorija je C++23; to ne potrjuje podpore izvajalnega okolja v produkciji. Navedena referenca vodi do razvijajočega se osnutka standarda, ne do nespremenjene izdaje C++23.
Primeri
#include <iostream>
#include <stop_token>
#include <thread>
int main() {
bool observed = false;
bool first = false;
bool second = false;
{
std::jthread worker([&observed](std::stop_token token) {
while (!token.stop_requested()) {
std::this_thread::yield();
}
observed = true;
});
first = worker.request_stop();
second = worker.request_stop();
}
std::cout << std::boolalpha
<< first << ' ' << second << ' ' << observed << '\n';
}
Rezultat
true false true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- C++ working draft — Concurrency support library [thread]
- C++ working draft — Constructors, move, and assignment [thread.jthread.cons]
- C++ working draft — Stop token handling [thread.jthread.stop]
- C++ working draft — Member functions [stopsource.mem]
- C++ working draft — Stop token concepts [stoptoken.concepts]
- C++ working draft — Member functions [thread.jthread.mem] (unofficial HTML rendering)