Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::jthread — automatické připojení a kooperativní zastavení

std::jthread spravuje vlákno a při zničení objektu, ke kterému se lze ještě připojit, požádá o zastavení a poté čeká na dokončení. std::jthread::request_stop běh násilně nepřeruší: vlákno musí spolupracovat, například kontrolou std::stop_token.

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

Syntaxe

#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 přesunutelný, nekopírovatelný vlastník vlákna. Konstruktor ověřuje platnost volání podle typů volatelného objektu a argumentů po transformaci pomocí std::decay_t, nikoli podle původně předaných výrazů. Má-li std::is_invocable_v<std::decay_t<F>, std::stop_token, std::decay_t<Args>...> hodnotu true (kde F a Args... jsou odvozené typy volatelného objektu a argumentů), konstruktor zvolí volání s std::stop_token jako prvním argumentem. Jinak zvolí volání bez tokenu, které musí být pro stejné transformované typy platné. Samotné obdržení tokenu podporu zastavení nezajišťuje.

std::jthread::request_stop() má signaturu bool request_stop() noexcept. Vrátí true, když toto volání jako první zaznamená požadavek do sdíleného stavu zastavení; další požadavky vracejí false. Bez stavu zastavení také vrátí false. Výsledek nepotvrzuje, že vlákno skončilo. Registrované funkce zpětného volání pro zastavení se vykonají synchronně během prvního úspěšného požadavku.

Pokud joinable() vrátí true, destruktor zavolá request_stop() a poté join(). Na rozdíl od std::thread tedy není před běžným opuštěním rozsahu nutné ruční připojení. Nejde však o vynucené zrušení: ignorování tokenu nebo setrvání v blokující operaci může dokončení neomezeně zpozdit. Zachycené reference musí zůstat platné, dokud vlákno neskončí.

V příkladu první požadavek vrátí true a druhý false. Destruktor počká na dokončení vlákna, než se přečte observed, takže tato běžná proměnná bool zde nepotřebuje atomické operace. Smyčka s yield() je pouze krátkou ukázkou aktivního čekání, nikoli efektivním vzorem čekání. Režim repozitáře je C++23; to nepotvrzuje podporu běhového prostředí v produkci. Uvedený odkaz vede k průběžně se vyvíjejícímu návrhu normy, nikoli k neměnnému vydání C++23.

Pří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ýsledek

true false true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje