KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

errno — C23-foutmacro

`errno` uit `<errno.h>` is een macro die expandeert tot een wijzigbare lvalue van type `int` met thread storage duration. Het is geen functie of constante: gebruik `errno`, nooit `errno()`, en elke thread heeft een eigen object.

Versie: C23

Syntax

errno

errno uit <errno.h> is een macro die expandeert tot een wijzigbare lvalue van type int met thread storage duration. Het is geen functie of constante: gebruik errno, nooit errno(), en elke thread heeft een eigen object.

Het voorbeeld zet errno = EDOM in de hoofdthread terwijl een worker zijn eigen errno = ERANGE zet. 1 1 bevestigt de workerwaarde en dat diens schrijfopdracht de waarde van de hoofdthread niet veranderde.

De initiële thread begint met nul, maar in andere threads is de beginrepresentatie onbepaald; geen bibliotheekfunctie zet errno ooit op nul. Zet het voor een gedocumenteerde aanroep op nul, lees het alleen als het resultaat falen aangeeft en bewaar het meteen. De macro onderdrukken voor objecttoegang of identifier errno definiëren is UB. De macro’s EDOM, ERANGE en EILSEQ zijn verschillende positieve gehele constanten van type int, maar hun getallen zijn implementatieafhankelijk. Zij duiden respectievelijk een domein-, bereik- en ongeldige multibytereeksfout aan; POSIX-waarden zoals EINTR vallen buiten de ISO C-kern.

Voorbeelden

#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;
}

Resultaat

1 1

Het voorbeeld zet `errno = EDOM` in de hoofdthread terwijl een worker zijn eigen `errno = ERANGE` zet. `1 1` bevestigt de workerwaarde en dat diens schrijfopdracht de waarde van de hoofdthread niet veranderde.

Bronnen