Namespaces
Variants

std::jthread:: join

From cppreference.net

Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
void join ( ) ;
(начиная с C++20)

Блокирует текущий поток до тех пор, пока поток, идентифицируемый * this не завершит свое выполнение.

Завершение потока, идентифицируемого * this синхронизируется с соответствующим успешным возвратом из join() .

На объекте * this не выполняется синхронизация. Одновременный вызов join ( ) одного и того же объекта jthread из нескольких потоков создаёт состояние гонки данных, приводящее к неопределённому поведению.

Содержание

Параметры

(нет)

Возвращаемое значение

(нет)

Постусловия

joinable() имеет значение false .

Исключения

std::system_error если возникает ошибка.

Условия ошибок

Пример

#include <chrono>
#include <iostream>
#include <thread>
void foo()
{
    // simulate expensive operation
    std::this_thread::sleep_for(std::chrono::seconds(1));
}
void bar()
{
    // simulate expensive operation
    std::this_thread::sleep_for(std::chrono::seconds(1));
}
int main()
{
    std::cout << "starting first helper...\n";
    std::jthread helper1(foo);
    std::cout << "starting second helper...\n";
    std::jthread helper2(bar);
    std::cout << "waiting for helpers to finish..." << std::endl;
    helper1.join();
    helper2.join();
    std::cout << "done!\n";
}

Вывод:

starting first helper...
starting second helper...
waiting for helpers to finish...
done!

Ссылки

  • Стандарт C++23 (ISO/IEC 14882:2024):
  • 33.4.4.3 Члены [thread.jthread.mem]
  • Стандарт C++20 (ISO/IEC 14882:2020):
  • 32.4.3.2 Члены [thread.jthread.mem]

Смотрите также

позволяет потоку выполняться независимо от дескриптора потока
(public member function)
проверяет, является ли поток присоединяемым, т.е. потенциально выполняющимся в параллельном контексте
(public member function)
C documentation для thrd_join