CKTIS / C
thrd_create — vytvoření vlákna
thrd_create spustí func(arg) v novém vlákně a prostřednictvím thr uloží jeho identifikátor. Volání vrací stav vytvoření, nikoli výsledek funkce spuštěné ve vlákně.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);thrd_create z <threads.h> vytvoří vlákno, které vykonává func(arg). thr ukazuje na místo pro uložení jeho identifikátoru; func má typ kompatibilní s int (*)(void *). Předává se ukazatel arg, nikoli kopie objektu, na který ukazuje.
Návratová hodnota je thrd_success, thrd_nomem nebo thrd_error. Návrat z func odpovídá volání thrd_exit s jejím výsledkem. Dokončení thrd_create je synchronizováno se začátkem nového vlákna; neznamená to, že jeho práce skončila.
Udržujte data argumentu platná až do jejich posledního použití. Výsledek získejte pomocí thrd_join; pokud není nutné čekat, zajistěte volání thrd_detach. Samotné vytvoření vlákna nechrání před pozdějšími souběžnými přístupy ke sdíleným datům.
V příkladu zůstává input platný během čekání. Očekávaný výstup předpokládá úspěch obou operací. Příznak překladače C23 v repozitáři nepotvrzuje dostupnost produkčního běhového prostředí pro vlákna.
Příklady
#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;
}
Výsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.