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

CKTIS / C

perror — apresentar a mensagem correspondente a errno

perror de <stdio.h> apresenta em stderr uma mensagem relativa ao valor atual de errno, opcionalmente precedida por uma descrição própria. Não deteta erros nem devolve qualquer valor.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdio.h>
void perror(const char *s);

perror(s) descreve o valor atual de errno. A declaração é disponibilizada por <stdio.h>; inclui <errno.h> para usar errno diretamente. A função devolve void.

Se s não for um ponteiro nulo nem uma cadeia vazia, apresenta essa cadeia, seguida de : , da mensagem e de um carácter de nova linha. Caso contrário, omite o prefixo e o separador. Escreve em stderr, não em stdout; o texto da mensagem corresponde a strerror(errno).

Verifica primeiro o resultado da operação: perror não deteta falhas. Usa-a quando a documentação da operação indicar que esta define errno, antes de outra chamada alterar esse valor. O exemplo atribui deliberadamente EDOM, em vez de provocar uma falha real. O texto exato da mensagem depende da implementação.

Exemplos

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

int main(void)
{
    errno = EDOM;
    perror("demo");
    return 0;
}

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