WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

strerror — einen Fehlercode beschreiben

strerror wandelt einen Fehlercode in eine Meldung um. Der zurückgegebene Text hängt von der Implementierung und der Locale ab.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <string.h>
char *strerror(int errnum);

strerror(errnum) aus <string.h> gibt für jeden int-Wert eine Meldung zurück, meist für einen Wert, der aus errno stammt. Die Funktion beschreibt einen Code; sie erkennt nicht, ob eine Operation fehlgeschlagen ist.

Auch wenn der Rückgabetyp char * lautet, darf das zurückgegebene Array nicht verändert werden. Ein weiterer Aufruf von strerror kann den Inhalt des Arrays überschreiben. Verwende den zurückgegebenen Zeiger nicht mehr, sobald der Thread, der ihn erhalten hat, beendet ist. Wenn du den Text nach einem weiteren Aufruf oder nach dem Ende dieses Threads brauchst, kopiere ihn vorher.

Gleichzeitige Aufrufe können zu Datenrennen führen. Verlasse dich nicht auf einen bestimmten Wortlaut der Meldung. Das Beispiel übergibt EDOM, ohne absichtlich einen Fehler auszulösen.

Beispiele

#include <errno.h>
#include <stdio.h>
#include <string.h>

int main(void)
{
    const char *message = strerror(EDOM);
    printf("message_available=%d\n", message != NULL && message[0] != '\0');
    return 0;
}

Ergebnis

message_available=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.

Quellen