std::jthread

class jthread;

Класс jthread представляет отдельный поток выполнения. Он имеет такое же общее поведение, как и std::thread, за исключением того, что jthread автоматически присоединяется при уничтожении и может быть отменён/остановлен в определённых ситуациях.

Потоки начинают выполнение немедленно после создания объекта потока (с учётом возможных задержек планирования ОС), начиная с функции верхнего уровня, предоставленной в качестве аргумента конструктора. Возвращаемое значение функции верхнего уровня игнорируется, а если оно завершается сбросом исключения, вызывается std::terminate. Функция верхнего уровня может передать своё возвращаемое значение или исключение вызывающей стороне через std::promise или путём изменения общих переменных (что может потребовать синхронизации, см. std::mutex и std::atomic).

В отличие от std::thread, jthread логически содержит внутренний закрытый член типа std::stop_source, который поддерживает общее состояние остановки. Конструктор jthread принимает функцию, которая в качестве первого аргумента принимает std::stop_token, который передаётся jthread из её внутреннего std::stop_source. Это позволяет функции проверять, было ли запрошено приостановление во время выполнения, и возвращаться, если это так.

Объекты std::jthread также могут находиться в состоянии, которое не представляет ни одного потока (после создания по умолчанию, перемещения, detach, или join), и поток выполнения может не быть связан ни с одним объектом jthread (после detach).

Два объекта std::jthread не могут представлять один и тот же поток выполнения; std::jthread не является CopyConstructible или CopyAssignable, хотя он является MoveConstructible и MoveAssignable.

Типы членов

Члены-функции

Функции, не являющиеся членами

Примечания

См. также