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.