WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

errno — C23-Fehlermakro

`errno` aus `<errno.h>` ist ein Makro, das zu einem änderbaren Lvalue vom Typ `int` mit Thread-Speicherdauer expandiert. Es ist weder Funktion noch Konstante: `errno`, niemals `errno()`, und jeder Thread hat sein eigenes Objekt.

Version: C23

Syntax

errno

errno aus <errno.h> ist ein Makro, das zu einem änderbaren Lvalue vom Typ int mit Thread-Speicherdauer expandiert. Es ist weder Funktion noch Konstante: errno, niemals errno(), und jeder Thread hat sein eigenes Objekt.

Das Beispiel setzt im Hauptthread errno = EDOM, während ein Worker sein eigenes errno = ERANGE setzt. 1 1 bestätigt den Workerwert und dass dessen Schreibzugriff den Wert des Hauptthreads nicht änderte.

Der initiale Thread beginnt mit null, in anderen Threads ist die Anfangsrepräsentation unbestimmt; keine Bibliotheksfunktion setzt errno je auf null. Vor einem dokumentierten Aufruf null setzen, nur bei gemeldetem Fehler prüfen und sofort sichern. Unterdrücken des Makros für Objektzugriff oder Definieren eines Identifikators errno ist UB. Die Makros EDOM, ERANGE und EILSEQ sind verschiedene positive Ganzzahlkonstanten vom Typ int; ihre Zahlen sind jedoch implementationsdefiniert. Sie bezeichnen Definitionsbereichs-, Wertebereichs- beziehungsweise ungültige Mehrbytefolgenfehler; POSIX-Werte wie EINTR gehören nicht zum ISO-C-Kern.

Beispiele

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

Ergebnis

1 1

Das Beispiel setzt im Hauptthread `errno = EDOM`, während ein Worker sein eigenes `errno = ERANGE` setzt. `1 1` bestätigt den Workerwert und dass dessen Schreibzugriff den Wert des Hauptthreads nicht änderte.

Quellen