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

CKTIS / C

<threads.h> — threads em C

O cabeçalho <threads.h> disponibiliza threads, sincronização e dados específicos de cada thread. Verifique se está disponível na sua implementação.

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

Sintaxe

#include <threads.h>

<threads.h> declara funcionalidades para threads (thrd_*), mutexes (mtx_*), variáveis de condição (cnd_*), dados específicos de cada thread (tss_*) e call_once. As interfaces de gestão de threads utilizam struct timespec, mas incluir <threads.h> não garante que as restantes declarações e macros de <time.h> estejam disponíveis. Se precisar delas, inclua <time.h> diretamente.

Uma implementação que defina __STDC_NO_THREADS__ não é obrigada a disponibilizar este cabeçalho. O modo de compilação C23, por si só, não confirma a disponibilidade da biblioteca nem o suporte em tempo de execução em produção.

O exemplo verifica os resultados das operações. thrd_join aguarda pela terminação da thread e guarda o respetivo resultado do tipo int; este é distinto do estado de sucesso do próprio thrd_join. Em caso de sucesso, o programa escreve 42. O acesso concorrente a dados partilhados requer sincronização adequada; volatile não a substitui.

Exemplos

#include <stdio.h>

#ifdef __STDC_NO_THREADS__
#error "C threads support required"
#else
#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 1;
    if (thrd_join(thread, &result) != thrd_success)
        return 1;

    printf("%d\n", result);
    return 0;
}
#endif

Resultado

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