WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

<errno.h> — Fehlercodes

Der Header <errno.h> stellt errno und Makros für Fehlercodes bereit. Interpretiere sie entsprechend dem Vertrag der aufgerufenen Funktion.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <errno.h>

<errno.h> definiert das Makro errno: einen modifizierbaren L-Wert vom Typ int mit Thread-Speicherdauer, keine gewöhnliche globale Variable. Deaktiviere dieses Makro nicht und deklariere keinen eigenen Bezeichner namens errno.

EDOM, EILSEQ und ERANGE stehen jeweils für Domänen-, Kodierungs- und Bereichsfehler. Es handelt sich um verschiedene positive Konstanten vom Typ int; vergleiche die Namen, nicht die Zahlen.

Prüfe errno nur entsprechend dem Vertrag der Funktion: Ein Wert ungleich null allein beweist keinen Fehler. Wenn das Zurücksetzen erforderlich ist, setze errno = 0 vor dem Aufruf; lies oder sichere den Wert, bevor ein weiterer Bibliotheksaufruf erfolgt. Bibliotheksfunktionen setzen errno nicht automatisch zurück.

Beispiele

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

int main(void)
{
    errno = ERANGE;
    int saved_error = errno;
    errno = 0;
    int cleared = errno == 0;

    printf("saved ERANGE: %d\n", saved_error == ERANGE);
    printf("cleared: %d\n", cleared);
    return 0;
}

Ergebnis

saved ERANGE: 1
cleared: 1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen