Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

thrd_join — esperar pela terminação de uma thread

thrd_join bloqueia a thread que faz a chamada até a thread indicada terminar e, opcionalmente, obtém o respetivo resultado do tipo int. O estado da operação é distinto do resultado da thread.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

thrd_join, de <threads.h>, espera que a thread thr termine. Se res não for nulo, o resultado é guardado nesse endereço; com NULL, o resultado não é obtido.

A função devolve thrd_success ou thrd_error, não o resultado da thread. Este provém do valor devolvido pela função da thread ou de thrd_exit. Lê-o apenas depois de a chamada ter sido bem-sucedida.

A terminação da thread está sincronizada com a conclusão de thrd_join. A thread de destino não pode já ter sido desligada ou submetida a join. Não pressuponhas que a violação deste requisito devolve thrd_error.

Exemplos

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

Resultado

result = 42

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes