WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen