Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje