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

CKTIS / C

thrd_join — čekání na ukončení vlákna

thrd_join zablokuje volající vlákno, dokud zadané vlákno neskončí, a volitelně získá jeho výsledek typu int. Stav operace je oddělený od výsledku vlákna.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

#include <threads.h>
int thrd_join(thrd_t thr, int *res);

thrd_join z <threads.h> čeká, až vlákno thr skončí. Pokud res není nulový ukazatel, uloží se výsledek na tuto adresu; při hodnotě NULL se výsledek nezíská.

Funkce vrací thrd_success nebo thrd_error, nikoli výsledek vlákna. Ten pochází z návratové hodnoty funkce vlákna nebo z thrd_exit. Čtěte jej až po úspěšném volání.

Ukončení vlákna je synchronizováno s dokončením thrd_join. Cílové vlákno nesmí být předtím odpojeno ani spojeno pomocí join. Nepředpokládejte, že porušení tohoto požadavku vrátí thrd_error.

Příklady

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

static int worker(void *arg)
{
    (void)arg;
    return 42;
}

int main(void)
{
    thrd_t thread;
    int result;

    if (thrd_create(&thread, worker, NULL) != thrd_success)
        return EXIT_FAILURE;

    if (thrd_join(thread, &result) != thrd_success)
        return EXIT_FAILURE;

    printf("result = %d\n", result);
    return EXIT_SUCCESS;
}

Výsledek

result = 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