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.