CKTIS / C
thrd_join — čakanje na končanje niti
thrd_join blokira klicno nit, dokler se navedena nit ne konča, in po želji pridobi njen rezultat tipa int. Stanje operacije je ločeno od rezultata niti.
Različica: 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> počaka, da se nit thr konča. Če res ni ničelni kazalec, se rezultat shrani na ta naslov; z vrednostjo NULL se rezultat ne pridobi.
Funkcija vrne thrd_success ali thrd_error, ne pa rezultata niti. Ta izhaja iz vrnjene vrednosti funkcije niti ali iz thrd_exit. Preberite ga šele po uspešnem klicu.
Končanje niti je sinhronizirano z dokončanjem thrd_join. Ciljna nit ne sme biti že odklopljena ali združena s klicem join. Ne predpostavljajte, da kršitev te zahteve vrne thrd_error.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.