Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

thrd_join — oczekiwanie na zakończenie wątku

thrd_join blokuje wywołujący wątek do zakończenia wskazanego wątku i opcjonalnie odbiera jego wynik typu int. Status operacji jest odrębny od wyniku wątku.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <threads.h>
int thrd_join(thrd_t thr, int *res);

thrd_join z <threads.h> czeka na zakończenie wątku thr. Dla niepustego res zapisuje jego wynik pod tym adresem; NULL pomija odbiór wyniku.

Zwraca thrd_success albo thrd_error, nie wynik wątku. Wynik pochodzi z powrotu funkcji wątku lub thrd_exit. Odczytuj go dopiero po sukcesie.

Zakończenie wątku synchronizuje się z ukończeniem thrd_join. Wątek docelowy nie może być wcześniej odłączony ani połączony przez join. Nie zakładaj, że naruszenie tego wymagania zwróci thrd_error.

Przykłady

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

Wynik

result = 42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła