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.