std::jthread:: join
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Observers | ||||
| Operations | ||||
|
jthread::join
|
||||
| Stop token handling | ||||
| Non-member functions | ||||
|
void
join
(
)
;
|
(начиная с C++20) | |
Блокирует текущий поток до тех пор, пока поток, идентифицируемый * this не завершит свое выполнение.
Завершение потока, идентифицируемого
*
this
синхронизируется с
соответствующим успешным возвратом из
join()
.
На объекте * this не выполняется синхронизация. Одновременный вызов join ( ) одного и того же объекта jthread из нескольких потоков создаёт состояние гонки данных, приводящее к неопределённому поведению.
Содержание |
Параметры
(нет)
Возвращаемое значение
(нет)
Постусловия
joinable() имеет значение false .
Исключения
std::system_error если возникает ошибка.
Условия ошибок
- resource_deadlock_would_occur если this - > get_id ( ) == std:: this_thread :: get_id ( ) (обнаружена взаимная блокировка).
- no_such_process если поток не является допустимым.
- invalid_argument если joinable() равно false .
Пример
#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
|
|