errno

errno ist ein Präprozessor-Makro (siehe jedoch Hinweis unten), das zu einem thread-lokalen (seit C11) modifizierbaren L-Wert vom Typ int expandiert. Mehrere Standardbibliotheksfunktionen zeigen Fehler an, indem sie positive Ganzzahlen in errno schreiben. Typischerweise wird der Wert von errno auf einen der Fehlercodes gesetzt, die in <errno.h> als Makrokonstanten aufgeführt sind, die mit dem Buchstaben E beginnen, gefolgt von Großbuchstaben oder Ziffern.

Der Wert von errno ist ​ 0 ​ beim Programmstart, und obwohl Bibliotheksfunktionen positive Ganzzahlen in errno schreiben dürfen, unabhängig davon, ob ein Fehler aufgetreten ist, speichern Bibliotheksfunktionen niemals ​ 0 ​ in errno .

Bibliotheksfunktionen perror und strerror können verwendet werden, um textuelle Beschreibungen der Fehlerzustände zu erhalten, die dem aktuellen errno -Wert entsprechen.

Hinweis: Bis C11 hatten die C-Standards widersprüchliche Anforderungen, da sie sagten, dass errno ein Makro ist, aber auch dass "es nicht spezifiziert ist, ob errno ein Makro oder ein Bezeichner mit externer Bindung ist". C11 behebt dies, indem es vorschreibt, dass es als Makro definiert werden muss (siehe auch WG14 N1338 ).

Beispiel

#include <errno.h>
#include <math.h>
#include <stdio.h>
void show_errno(void)
{
    const char *err_info = "unknown error";
    switch (errno)
    {
        case EDOM:
            err_info = "domain error";
            break;
        case EILSEQ:
            err_info = "illegal sequence";
            break;
        case ERANGE:
            err_info = "pole or range error";
            break;
        case 0:
            err_info = "no error";
    }
    fputs(err_info, stdout);
    puts(" occurred");
}
int main(void)
{
    fputs("MATH_ERRNO is ", stdout);
    puts(math_errhandling & MATH_ERRNO ? "set" : "not set");
    errno = 0;
    (void)(1.0 / 0.0);
    show_errno();
    errno = 0;
    (void)acos(+1.1);
    show_errno();
    errno = 0;
    (void)log(0.0);
    show_errno();
    errno = 0;
    (void)sin(0.0);
    show_errno();
}

MATH_ERRNO is set
no error occurred
domain error occurred
pole or range error occurred
no error occurred

Referenzen

Siehe auch