CKTIS / C++
std::jthread — automatsko pridruživanje i kooperativno zaustavljanje
std::jthread upravlja dretvom i pri uništavanju objekta kojem se još može pridružiti traži zaustavljanje, a zatim čeka završetak. std::jthread::request_stop ne prekida izvođenje prisilno: dretva mora surađivati, primjerice provjeravanjem std::stop_token.
Verzija: 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 zaglavlja <thread> premjestiv je, nekopirljiv vlasnik dretve. Konstruktor provjerava valjanost poziva na temelju tipova pozivnog objekta i argumenata nakon pretvorbe pomoću std::decay_t, a ne na temelju izvorno predanih izraza. Ako je vrijednost izraza std::is_invocable_v<std::decay_t<F>, std::stop_token, std::decay_t<Args>...> jednaka true (pri čemu su F i Args... izvedeni tipovi pozivnog objekta i argumenata), konstruktor odabire poziv sa std::stop_token kao prvim argumentom. U suprotnom odabire poziv bez tokena, koji mora biti valjan za iste pretvorene tipove. Samo primanje tokena ne znači da je zaustavljanje implementirano.
std::jthread::request_stop() ima potpis bool request_stop() noexcept. Vraća true kada ovaj poziv prvi put zabilježi zahtjev u zajedničkom stanju zaustavljanja; sljedeći zahtjevi vraćaju false. Vraća false i kada ne postoji stanje zaustavljanja. Rezultat ne potvrđuje da je dretva završila. Registrirane povratne funkcije za zaustavljanje izvršavaju se sinkrono tijekom prvog uspješnog zahtjeva.
Ako joinable() vrati true, destruktor poziva request_stop(), a zatim join(). Za razliku od std::thread, zato nije potrebno ručno pridruživanje prije uobičajenog izlaska iz dosega. To ipak nije prisilno otkazivanje: ignoriranje tokena ili ostanak u blokirajućoj operaciji može neograničeno odgoditi završetak. Uhvaćene reference moraju ostati valjane dok dretva ne završi.
U primjeru prvi zahtjev daje true, a drugi false. Destruktor čeka da dretva završi prije čitanja varijable observed, pa ovom običnom bool ovdje nisu potrebne atomske operacije. Petlja s yield() samo je kratka demonstracija aktivnog čekanja, a ne učinkovit obrazac čekanja. Način repozitorija je C++23; to ne potvrđuje podršku izvršnog okruženja u produkciji. Navedena referenca vodi na nacrt standarda koji se razvija, a ne na nepromjenjivo izdanje C++23.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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)