Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła