Namensräume
Varianten
Aktionen

std::jthread::join

Von cppreference.com
< cpp‎ | thread‎ | jthread
 
 
Bibliothek für nebenläufige Programmierung
Threads
(C++11)
(C++20)
this_thread Namespace
(C++11)
(C++11)
(C++11)
Kooperatives Beenden
Gegenseitiger Ausschluss
(C++11)
Allgemeines Sperrungsmanagement
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Bedingungsvariablen
(C++11)
Semaphoren
Latches und Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
Sichere Wiederherstellung
(C++26)
Hazard Pointer
Atomare Typen
(C++11)
(C++20)
Initialisierung von atomaren Typen
(C++11)(veraltet in C++20)
(C++11)(veraltet in C++20)
Speicherordnung
(C++11)(deprecated in C++26)
Freie Funktionen für atomare Operationen
Freie Funktionen für atomare Flags
 
 
void join();
(seit C++20)

Blockiert den aktuellen Thread, bis der durch *this identifizierte Thread seine Ausführung beendet.

Die Beendigung des durch *this identifizierten Threads synchronisiert mit der entsprechenden erfolgreichen Rückkehr von join().

Keine Synchronisation wird auf *this selbst durchgeführt. Gleichzeitiges Aufrufen von join() für dasselbe jthread-Objekt von mehreren Threads aus stellt ein Datenrennen dar, das zu undefiniertem Verhalten führt.

Inhalt

[bearbeiten] Parameter

(keine)

[bearbeiten] Rückgabewert

(keine)

[bearbeiten] Nachbedingungen

joinable() ist false.

[bearbeiten] Ausnahmen

std::system_error, wenn ein Fehler auftritt.

[bearbeiten] Fehlerbedingungen

[bearbeiten] Beispiel

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

Ausgabe

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

[bearbeiten] Referenzen

  • C++23 Standard (ISO/IEC 14882:2024)
  • 33.4.4.3 Members [thread.jthread.mem]
  • C++20 Standard (ISO/IEC 14882:2020)
  • 32.4.3.2 Members [thread.jthread.mem]

[bearbeiten] Siehe auch

erlaubt dem Thread, unabhängig vom Thread-Handle ausgeführt zu werden
(öffentliche Mitgliedsfunktion) [bearbeiten]
prüft, ob der Thread joinable ist, d.h. ob er potenziell in einem parallelen Kontext läuft
(öffentliche Mitgliedsfunktion) [bearbeiten]
C-Dokumentation für thrd_join