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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- 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)