CKTIS / C
thrd_create — ustvarjanje niti
thrd_create zažene func(arg) v novi niti in prek thr shrani njen identifikator. Klic vrne stanje ustvarjanja, ne pa rezultata funkcije, ki se izvaja v niti.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);thrd_create iz <threads.h> ustvari nit, ki izvaja func(arg). thr kaže na prostor za njen identifikator; func ima tip, združljiv z int (*)(void *). Posreduje se kazalec arg, ne kopija objekta, na katerega kaže.
Vrnjena vrednost je thrd_success, thrd_nomem ali thrd_error. Vrnitev iz func je enakovredna klicu thrd_exit z njenim rezultatom. Zaključek funkcije thrd_create je sinhroniziran z začetkom nove niti; to ne pomeni, da je njeno delo končano.
Podatki argumenta naj ostanejo veljavni do zadnje uporabe. Rezultat pridobi z thrd_join; če čakanje ni potrebno, poskrbi za klic thrd_detach. Samo ustvarjanje niti ne ščiti poznejših sočasnih dostopov do skupnih podatkov.
V primeru input ostane veljaven med čakanjem. Pričakovani izpis predpostavlja, da sta obe operaciji uspešni. Zastavica prevajalnika C23 v repozitoriju ne potrjuje, da je na voljo izvajalno okolje za niti, primerno za produkcijo.
Primeri
#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;
}
Rezultat
42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.