CKTIS / C
strerror — descrever um código de erro
strerror converte um código de erro num texto. O texto devolvido depende da implementação e da configuração regional.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <string.h>
char *strerror(int errnum);strerror(errnum) de <string.h> devolve um texto para qualquer valor do tipo int, geralmente obtido de errno. A função descreve um código; não deteta se uma operação falhou.
Apesar de o tipo devolvido ser char *, não modifique o array devolvido. Uma chamada posterior a strerror pode sobrescrever o conteúdo do array. Não utilize o apontador devolvido depois de a thread que o obteve terminar. Se precisar do texto após outra chamada ou após o fim dessa thread, copie-o antes.
Chamadas concorrentes podem causar corridas de dados. Não presuma uma formulação específica para o texto. O exemplo passa EDOM sem provocar deliberadamente um erro.
Exemplos
#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;
}
Resultado
message_available=1
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.