CKTIS / C
<errno.h> — kody błędów
Nagłówek <errno.h> udostępnia errno i makra kodów błędów. Interpretuj je zgodnie z kontraktem wywoływanej funkcji.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <errno.h><errno.h> definiuje makro errno: modyfikowalną l-wartość typu int z czasem przechowywania wątku, nie zwykłą zmienną globalną. Nie wyłączaj tego makra ani nie deklaruj własnego identyfikatora errno.
EDOM, EILSEQ i ERANGE oznaczają odpowiednio błędy dziedziny, kodowania i zakresu. Są różnymi dodatnimi stałymi typu int; porównuj nazwy, nie liczby.
Sprawdzaj errno tylko zgodnie z kontraktem funkcji: niezerowa wartość sama nie dowodzi błędu. Gdy wymagane jest zerowanie, ustaw errno = 0 przed wywołaniem; odczytaj lub zachowaj wynik przed kolejnym wywołaniem bibliotecznym. Funkcje biblioteczne nie zerują automatycznie errno.
Przykłady
#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;
}
Wynik
saved ERANGE: 1 cleared: 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.