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.