Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

thrd_join — čakanje na končanje niti

thrd_join blokira klicno nit, dokler se navedena nit ne konča, in po želji pridobi njen rezultat tipa int. Stanje operacije je ločeno od rezultata niti.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

thrd_join iz <threads.h> počaka, da se nit thr konča. Če res ni ničelni kazalec, se rezultat shrani na ta naslov; z vrednostjo NULL se rezultat ne pridobi.

Funkcija vrne thrd_success ali thrd_error, ne pa rezultata niti. Ta izhaja iz vrnjene vrednosti funkcije niti ali iz thrd_exit. Preberite ga šele po uspešnem klicu.

Končanje niti je sinhronizirano z dokončanjem thrd_join. Ciljna nit ne sme biti že odklopljena ali združena s klicem join. Ne predpostavljajte, da kršitev te zahteve vrne thrd_error.

Primeri

#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;
}

Rezultat

result = 42

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri