База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::jthread — автоматично присъединяване и кооперативно спиране

std::jthread управлява нишка и при унищожаване на обект, към който все още може да се присъедини, заявява спиране и след това изчаква завършването. std::jthread::request_stop не прекъсва изпълнението принудително: нишката трябва да съдейства, например като проверява std::stop_token.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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 от <thread> е преместваем, некопируем собственик на нишка. Конструкторът проверява дали извикването е допустимо според типовете на извикваемия обект и аргументите след преобразуване чрез std::decay_t, а не според първоначално подадените изрази. Ако std::is_invocable_v<std::decay_t<F>, std::stop_token, std::decay_t<Args>...> има стойност true (където F и Args... са изведените типове на извикваемия обект и аргументите), конструкторът избира извикването със std::stop_token като първи аргумент. В противен случай избира извикването без токен, което трябва да е допустимо за същите преобразувани типове. Самото получаване на токен не осигурява поддръжка на спирането.

std::jthread::request_stop() има сигнатура bool request_stop() noexcept. Връща true, когато това извикване за първи път записва заявка в споделеното състояние за спиране; следващите заявки връщат false. Връща false и когато няма състояние за спиране. Резултатът не потвърждава, че нишката е приключила. Регистрираните обратни извиквания за спиране се изпълняват синхронно по време на първата успешна заявка.

Ако joinable() върне true, деструкторът извиква request_stop(), а след това join(). Следователно, за разлика от std::thread, не е необходимо ръчно присъединяване преди обичайното излизане от обхвата. Това обаче не е принудително отменяне: игнорирането на токена или оставането в блокираща операция може да забави завършването неограничено. Заловените препратки трябва да останат валидни, докато нишката приключи.

В примера първата заявка връща true, а втората — false. Деструкторът изчаква нишката да приключи, преди да бъде прочетена observed, така че тази обикновена променлива bool не се нуждае от атомарни операции тук. Цикълът с yield() е само кратка демонстрация на активно изчакване, а не ефективен модел за изчакване. Режимът на хранилището е C++23; това не удостоверява поддръжка на средата за изпълнение в продукция. Посочената справка води към развиващ се проект на стандарт, а не към фиксирано издание на C++23.

Примери

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

Резултат

true false true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници