CKTIS / C
thrd_join — auf das Ende eines Threads warten
thrd_join blockiert den aufrufenden Thread, bis der angegebene Thread beendet ist, und ruft optional dessen int-Ergebnis ab. Der Status des Vorgangs ist vom Thread-Ergebnis getrennt.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int thrd_join(thrd_t thr, int *res);thrd_join aus <threads.h> wartet, bis der Thread thr beendet ist. Bei einem Wert ungleich NULL wird das Ergebnis an der Adresse von res gespeichert; mit NULL wird das Ergebnis nicht abgerufen.
Die Funktion gibt thrd_success oder thrd_error zurück, nicht das Thread-Ergebnis. Dieses stammt aus dem Rückgabewert der Thread-Funktion oder aus thrd_exit. Lies es erst nach einem erfolgreichen Aufruf aus.
Das Beenden des Threads ist mit dem Abschluss von thrd_join synchronisiert. Der Ziel-Thread darf nicht bereits abgetrennt oder mit Join verbunden worden sein. Gehe nicht davon aus, dass ein Verstoß gegen diese Anforderung thrd_error zurückgibt.
Beispiele
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
static int worker(void *arg)
{
(void)arg;
return 42;
}
int main(void)
{
thrd_t thread;
int result;
if (thrd_create(&thread, worker, NULL) != thrd_success)
return EXIT_FAILURE;
if (thrd_join(thread, &result) != thrd_success)
return EXIT_FAILURE;
printf("result = %d\n", result);
return EXIT_SUCCESS;
}
Ergebnis
result = 42
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.