Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strerror — opis kodu błędu

strerror przekształca kod błędu w komunikat. Zwrócony tekst zależy od implementacji i ustawień regionalnych.

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

Składnia

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

strerror(errnum) z <string.h> zwraca komunikat dla dowolnej wartości int, zwykle pochodzącej z errno. Funkcja opisuje kod; nie wykrywa błędu operacji.

Mimo typu wyniku char * nie wolno modyfikować zwróconej tablicy. Kolejne wywołanie strerror może nadpisać zawartość tej tablicy. Nie używaj zwróconego wskaźnika po zakończeniu wątku, który go uzyskał. Jeśli tekst ma być potrzebny po kolejnym wywołaniu lub po zakończeniu tego wątku, skopiuj go wcześniej.

Równoczesne wywołania mogą powodować wyścigi danych. Nie zakładaj konkretnego brzmienia komunikatu. Przykład przekazuje EDOM bez celowego wywoływania błędu.

Przykłady

#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;
}

Wynik

message_available=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła