CKTIS / C++
std::jthread — automatické pripojenie a kooperatívne zastavenie
std::jthread spravuje vlákno a pri zničení objektu, ku ktorému sa možno ešte pripojiť, požiada o zastavenie a potom čaká na dokončenie. std::jthread::request_stop beh násilne nepreruší: vlákno musí spolupracovať, napríklad kontrolou std::stop_token.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 z hlavičky <thread> je presúvateľný, nekopírovateľný vlastník vlákna. Konštruktor overuje platnosť volania podľa typov volateľného objektu a argumentov po transformácii pomocou std::decay_t, nie podľa pôvodne odovzdaných výrazov. Ak má std::is_invocable_v<std::decay_t<F>, std::stop_token, std::decay_t<Args>...> hodnotu true (kde F a Args... sú odvodené typy volateľného objektu a argumentov), konštruktor zvolí volanie s std::stop_token ako prvým argumentom. Inak zvolí volanie bez tokenu, ktoré musí byť platné pre tie isté transformované typy. Samotné prijatie tokenu nezabezpečuje podporu zastavenia.
std::jthread::request_stop() má signatúru bool request_stop() noexcept. Vráti true, keď toto volanie ako prvé zaznamená požiadavku do zdieľaného stavu zastavenia; ďalšie požiadavky vracajú false. Bez stavu zastavenia tiež vráti false. Výsledok nepotvrdzuje, že sa vlákno skončilo. Registrované funkcie spätného volania zastavenia sa vykonajú synchrónne počas prvej úspešnej požiadavky.
Ak joinable() vráti true, deštruktor zavolá request_stop() a potom join(). Na rozdiel od std::thread teda pred bežným opustením rozsahu nie je potrebné manuálne pripojenie. Nejde však o vynútené zrušenie: ignorovanie tokenu alebo zotrvanie v blokujúcej operácii môže dokončenie neobmedzene oddialiť. Zachytené referencie musia zostať platné, kým sa vlákno neskončí.
V príklade prvá požiadavka vráti true a druhá false. Deštruktor počká na dokončenie vlákna pred čítaním observed, takže táto obyčajná premenná bool tu nepotrebuje atómové operácie. Cyklus s yield() je len krátkou ukážkou aktívneho čakania, nie efektívnym vzorom čakania. Režim repozitára je C++23; to nepotvrdzuje podporu behového prostredia v produkcii. Uvedený odkaz vedie k priebežne sa vyvíjajúcemu návrhu normy, nie k nemennému vydaniu C++23.
Príklady
#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';
}
Výsledok
true false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
Zdroje
- 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)