CKTIS / C
thrd_create — stvaranje dretve
thrd_create pokreće func(arg) u novoj dretvi i putem thr pohranjuje njezin identifikator. Poziv vraća status stvaranja, a ne rezultat funkcije koja se izvršava u dretvi.
Verzija: 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> stvara dretvu koja izvršava func(arg). thr pokazuje na mjesto za pohranu njezina identifikatora; func ima tip kompatibilan s int (*)(void *). Prosljeđuje se pokazivač arg, a ne kopija objekta na koji pokazuje.
Povratna vrijednost je thrd_success, thrd_nomem ili thrd_error. Povratak iz func jednak je pozivu thrd_exit s njezinim rezultatom. Završetak funkcije thrd_create sinkroniziran je s početkom nove dretve; to ne znači da je njezin posao završen.
Podatke argumenta zadrži valjanima do njihove posljednje upotrebe. Rezultat preuzmi pomoću thrd_join; ako čekanje nije potrebno, organiziraj poziv funkcije thrd_detach. Samo stvaranje dretve ne štiti od kasnijih istodobnih pristupa zajedničkim podacima.
U primjeru input ostaje valjan tijekom čekanja. Očekivani izlaz pretpostavlja uspjeh obiju operacija. Oznaka prevoditelja C23 u repozitoriju ne potvrđuje dostupnost izvršnog okruženja za dretve prikladnog za produkciju.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.