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

CKTIS / C

thrd_create — criar uma thread

thrd_create inicia func(arg) numa nova thread e guarda o respetivo identificador através de thr. A chamada devolve o estado da criação, não o resultado da função executada pela thread.

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

Sintaxe

#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);

thrd_create de <threads.h> cria uma thread que executa func(arg). thr aponta para o espaço onde guardar o respetivo identificador; func tem um tipo compatível com int (*)(void *). É passado o ponteiro arg, não uma cópia do objeto para o qual aponta.

O valor devolvido é thrd_success, thrd_nomem ou thrd_error. O regresso de func equivale a chamar thrd_exit com o respetivo resultado. A conclusão de thrd_create está sincronizada com o início da nova thread; não significa que o trabalho desta tenha terminado.

Mantém válidos os dados do argumento até à sua última utilização. Obtém o resultado através de thrd_join; se não for necessário esperar, prepara uma chamada a thrd_detach. A criação da thread, por si só, não protege os acessos concorrentes posteriores a dados partilhados.

No exemplo, input continua válido durante a espera. O resultado esperado pressupõe que ambas as operações são bem-sucedidas. Uma opção de compilação C23 no repositório não atesta a disponibilidade de um ambiente de execução de threads adequado para produção.

Exemplos

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

static int worker(void *arg)
{
    return *(const int *)arg + 1;
}

int main(void)
{
    thrd_t thread;
    static int input = 41;
    int result;

    if (thrd_create(&thread, worker, &input) != thrd_success) {
        return EXIT_FAILURE;
    }
    if (thrd_join(thread, &result) != thrd_success) {
        return EXIT_FAILURE;
    }

    printf("%d\n", result);
    return EXIT_SUCCESS;
}

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