CKTIS / C
thrd_create — creare un thread
thrd_create avvia func(arg) in un nuovo thread e ne memorizza l’identificatore tramite thr. La chiamata restituisce lo stato della creazione, non il risultato della funzione eseguita dal thread.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);thrd_create di <threads.h> crea un thread che esegue func(arg). thr punta allo spazio in cui memorizzare il suo identificatore; func ha un tipo compatibile con int (*)(void *). Viene passato il puntatore arg, non una copia dell’oggetto a cui punta.
Il valore restituito è thrd_success, thrd_nomem oppure thrd_error. Il ritorno da func equivale a chiamare thrd_exit con il suo risultato. Il completamento di thrd_create è sincronizzato con l’inizio del nuovo thread; non significa che il suo lavoro sia terminato.
Mantieni validi i dati dell’argomento fino al loro ultimo utilizzo. Recupera il risultato con thrd_join; se non è necessario attendere, predisponi una chiamata a thrd_detach. La sola creazione del thread non protegge gli accessi concorrenti successivi ai dati condivisi.
Nell’esempio, input rimane valido durante l’attesa. L’output atteso presuppone che entrambe le operazioni riescano. Un’opzione del compilatore C23 nel repository non attesta la disponibilità di un ambiente di esecuzione dei thread adatto alla produzione.
Esempi
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
static int worker(void *arg)
{
return *(const int *)arg + 1;
}
int main(void)
{
thrd_t thread;
static int input = 41;
int result;
if (thrd_create(&thread, worker, &input) != thrd_success) {
return EXIT_FAILURE;
}
if (thrd_join(thread, &result) != thrd_success) {
return EXIT_FAILURE;
}
printf("%d\n", result);
return EXIT_SUCCESS;
}
Risultato
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.