KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

thrd_join — wachten tot een thread eindigt

thrd_join blokkeert de aanroepende thread totdat de opgegeven thread eindigt en haalt optioneel het int-resultaat ervan op. De status van de bewerking staat los van het threadresultaat.

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

Syntax

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

thrd_join uit <threads.h> wacht totdat thread thr eindigt. Als res niet null is, wordt het resultaat op dat adres opgeslagen; met NULL wordt het resultaat niet opgehaald.

De functie retourneert thrd_success of thrd_error, niet het threadresultaat. Dat resultaat komt van de returnwaarde van de threadfunctie of van thrd_exit. Lees het pas nadat de aanroep is geslaagd.

Het eindigen van de thread is gesynchroniseerd met het voltooien van thrd_join. De doelthread mag niet al zijn losgekoppeld of gejoined. Ga er niet van uit dat het schenden van deze vereiste thrd_error oplevert.

Voorbeelden

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

Resultaat

result = 42

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen