CKTIS / C
thrd_join — čekanje na završetak dretve
thrd_join blokira dretvu koja poziva funkciju dok navedena dretva ne završi i po želji dohvaća njezin rezultat tipa int. Status operacije odvojen je od rezultata dretve.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int thrd_join(thrd_t thr, int *res);thrd_join iz <threads.h> čeka da dretva thr završi. Ako res nije nulti pokazivač, rezultat se sprema na tu adresu; uz NULL rezultat se ne dohvaća.
Funkcija vraća thrd_success ili thrd_error, a ne rezultat dretve. Rezultat dolazi iz povratne vrijednosti funkcije dretve ili iz thrd_exit. Pročitajte ga tek nakon uspješnog poziva.
Završetak dretve sinkroniziran je s dovršetkom funkcije thrd_join. Ciljna dretva ne smije prethodno biti odvojena ni spojena pozivom join. Nemojte pretpostaviti da će kršenje ovog zahtjeva vratiti thrd_error.
Primjeri
#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;
}
Rezultat
result = 42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.