Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

thrd_join — attendere la terminazione di un thread

thrd_join blocca il thread chiamante finché il thread specificato non termina e, facoltativamente, ne recupera il risultato di tipo int. Lo stato dell’operazione è distinto dal risultato del thread.

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

Sintassi

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

thrd_join, dichiarata in <threads.h>, attende che il thread thr termini. Se res non è nullo, il risultato viene salvato all’indirizzo indicato; con NULL, il risultato non viene recuperato.

La funzione restituisce thrd_success oppure thrd_error, non il risultato del thread. Questo deriva dal valore restituito dalla funzione del thread o da thrd_exit. Leggilo solo dopo il successo della chiamata.

La terminazione del thread è sincronizzata con il completamento di thrd_join. Il thread di destinazione non deve essere già stato scollegato o raggiunto con una join. Non presumere che la violazione di questo requisito restituisca thrd_error.

Esempi

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

Risultato

result = 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti