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

CKTIS / C

errno — macro de erro C23

`errno` de `<errno.h>` é uma macro que expande para um lvalue modificável do tipo `int` com duração de armazenamento da thread. Não é função nem constante: usa `errno`, nunca `errno()`, e cada thread tem o seu objeto.

Versão: C23

Sintaxe

errno

errno de <errno.h> é uma macro que expande para um lvalue modificável do tipo int com duração de armazenamento da thread. Não é função nem constante: usa errno, nunca errno(), e cada thread tem o seu objeto.

O exemplo define errno = EDOM na thread principal, enquanto uma trabalhadora define o seu errno = ERANGE. 1 1 confirma o valor da trabalhadora e que a escrita não alterou o valor da thread principal.

A thread inicial começa em zero, mas nas outras threads a representação inicial é indeterminada; nenhuma função da biblioteca põe errno a zero. Antes de uma chamada documentada define zero, consulta apenas se o resultado indicar falha e guarda logo o valor. Suprimir a macro para aceder a um objeto ou definir um identificador errno é UB. As macros EDOM, ERANGE e EILSEQ são constantes inteiras positivas distintas do tipo int, mas os seus números dependem da implementação. Indicam respetivamente erro de domínio, de intervalo e de sequência multibyte inválida; valores POSIX como EINTR ficam fora do núcleo ISO C.

Exemplos

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

static int worker(void *unused) {
    (void)unused;
    errno = ERANGE;
    return errno == ERANGE ? 0 : 1;
}

int main(void) {
    errno = EDOM;
    thrd_t thread;
    if (thrd_create(&thread, worker, NULL) != thrd_success) return 1;
    int result;
    if (thrd_join(thread, &result) != thrd_success) return 1;
    printf("%d %d\n", result == 0, errno == EDOM);
    return 0;
}

Resultado

1 1

O exemplo define `errno = EDOM` na thread principal, enquanto uma trabalhadora define o seu `errno = ERANGE`. `1 1` confirma o valor da trabalhadora e que a escrita não alterou o valor da thread principal.

Fontes