Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes