BEZEICHNUNG¶

strerror, strerrorname_np, strerrordesc_np, strerror_r, strerror_l - gibt eine Zeichenkette zurück, die den Fehlercode beschreibt

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <string.h>

char *strerror(int fehlernum);
const char *strerrorname_np(int fehlernum);
const char *strerrordesc_np(int fehlernum);

int strerror_r(int fehlernum, char puf[.puflänge], size_t buflen);


               /* XSI-konform */

char *strerror_r(int fehlernum, char puf[.puflänge], size_t puflänge);


               /* GNU-spezifisch */

char *strerror_l(int fehlernum, locale_t locale);

strerrorname_np(), strerrordesc_np():

    _GNU_SOURCE

strerror_r():

    Die XSI-konforme Version wird bereitgestellt, falls:


        (_POSIX_C_SOURCE >= 200112L) && ! _GNU_SOURCE


    Anderenfalls wird die GNU-spezifische Version bereitgestellt.

BESCHREIBUNG¶

Die Funktion strerror() gibt einen Zeiger auf eine Zeichenkette mit der Beschreibung des Fehlercodes für das übergebene Argument fehlernum zurück. Möglicherweise wertet sie dabei den LC_MESSAGES-Teil der aktuellen Locale aus, um die passende Sprache zu wählen. (Falls beispielsweise fehlernum EINVAL ist, dann wird die zurückgelieferte Beschreibung »Invalid argument« sein.). Diese Zeichenkette darf nicht von der Anwendung verändert werden, wohl aber von einem nachfolgenden Aufruf von strerror() oder strerror_l(). Diese Zeichenkette wird von keiner anderen Bibliotheksfunktion, inklusive perror(3), verändert.

Wie strerror() gibt die Funktion strerrordesc_np() einen Zeiger auf eine Zeichenkette zurück, die den Fehlercode des im Argument fehlernum übergebenen Fehlers enthält, jedoch mit dem Unterschied, dass die zurückgegebene Zeichenkette nicht anhand der aktuellen Locale übersetzt ist.

Die Funktion strerrorname_np() gibt einen Zeiger auf eine Zeichenkette zurück, die den Namen des im Argument fehlernum übergebenen Fehlers enthält. Ist beispielsweise EPERM als Argument angegeben, gibt diese Funktion einen Zeiger auf die Zeichenkette »EPERM« zurück.

RÜCKGABEWERT¶

Die Funktionen strerror(), strerror_l() und die GNU-spezifische strerror_r() geben die entsprechende Zeichenkette mit der Fehlerbeschreibung zurück oder eine Nachricht »Unbekannter Fehler nnn«, wenn die Fehlernummer unbekannt ist.

Bei Erfolg geben strerrorname_np() und strerrordesc_np() die entsprechende den Fehler beschreibende Zeichenkette zurück. Falls fehlernum eine unzulässige Fehlernummer ist, geben diese Funktionen NULL zurück.

Die XSI-konforme Funktion strerror_r() gibt bei Erfolg 0 zurück. Im Fehlerfall wird eine positive Fehlernummer (seit Glibc 2.13) oder -1 zurückgegeben und errno mit einem Wert belegt, der den Fehler angibt (Glibc vor Version 2.13).

POSIX.1-2001 und POSIX.1-2008 verlangen, dass ein erfolgreicher Aufruf von strerror() oder strerror_l() errno unverändert belässt. Sie merken an, dass wegen des nicht definierten Rückgabewerts zur Anzeige eines Fehlers eine Anwendung zur Fehlerprüfung vor dem Aufruf errno auf Null setzen und nach dem Aufruf überprüfen sollte.

FEHLER¶

EINVAL

Der Wert von fehlernum ist keine gültige Fehlernummer.

ERANGE

Es wurde unzureichender Speicher für die Aufnahme der Fehler-Zeichenkette bereitgestellt.

VERSIONEN¶

Die Funktion strerror_l() kamen erstmals in Glibc 2.6 vor.

Die Funktionen strerrorname_np() und strerrordesc_np() kamen erstmals in Glibc 2.32 vor.

ATTRIBUTE¶

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS¶

strerror() wird von POSIX.1-2001, POSIX.1-2008 und C99 spezifiziert. strerror_r() wird von POSIX.1-2001 spezifiziert.

strerror_l() ist in POSIX.1-2008 spezifiziert.

Die GNU-spezifischen Funktionen strerror_r(), strerrorname_np() und strerrordesc_np() sind eine nicht standardisierte Erweiterungen.

POSIX.1-2001 gestattet strerror() das Setzen von errno wenn der Aufruf einen Fehler bewirkt, gibt aber nicht vor, welchen Wert die Funktion im Fehlerfall zurückgeben sollte. Auf einigen Systemen gibt strerror() NULL zurück, wenn die Fehlernummer nicht bekannt ist. Auf anderen Systemen gibt strerror() eine Meldung etwa wie »Fehler nnn aufgetreten« und setzt errno auf EINVAL, wenn die Fehlernummer unbekannt ist. C99 und POSIX.1-2008 verlangen, dass der Rückgabewert von NULL verschieden ist.

ANMERKUNGEN¶

Die GNU-C-Bibliothek verwendet einen Puffer von 1024 Zeichen für strerror(). Diese Puffergröße sollte daher ausreichen, um einen Fehler ERANGE beim Aufruf von strerror_r() zu vermeiden.

strerrorname_np() und strerrordesc_np() sind weder multithread-fähig noch asynchronsignalsicher.

SIEHE AUCH¶

err(3), errno(3), error(3), perror(3), strsignal(3), locale(7)

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.