perror Subrotina

Propósito

Escreve uma mensagem explicando um erro de subroutine.

Biblioteca

Biblioteca C padrão (libc.a)

Sintaxe

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

void perror ( String)
const char *String;
extern int errno;
extern char *sys_errlist[ ];
extern int sys_nerr;

Descrição

A sub-rotina perror grava uma mensagem na saída de erro padrão que descreve o último erro encontrado por uma chamada de sistema ou sub-rotina de biblioteca. A mensagem de erro inclui a sequência do parâmetro String seguida por um: (Colon), um caractere de espaço, a mensagem e um caractere de nova linha. A sequência do parâmetro String deve incluir o nome do programa que causou o erro.. O número do erro é obtido da variável global errno , que é configurada quando ocorre um erro, mas não é limpa quando é feita uma chamada bem-sucedida para a sub-rotina perror .

Para simplificar vários formatos de mensagem, uma matriz de sequências de mensagens é fornecida na estrutura sys_errlist ou usar a variável global errno como um índice na estrutura sys_errlist para obter a sequência de mensagem sem o caractere de nova linha... O maior número de mensagens fornecido na tabela é sys_nerr. Certifique-se de verificar a estrutura sys_nerr porque novos códigos de erros podem ser incluídos no sistema antes de serem incluídos na tabela.

A sub-rotina perror recupera uma mensagem de erro com base no idioma do código de idioma atual

Após concluir com êxito e antes de uma chamada para a sub-rotina exit ou abort ou a conclusão da sub-rotina fflush ou fclose no fluxo de erro padrão, a sub-rotina perror marca para atualizar os campos st_ctime e st_mtime do arquivo associado ao fluxo de erro padrão.

Parâmetro

Tabela 1. Parâmetro
Item Descrição
String Especifica uma sequência de parâmetros que contém o nome do programa que causou o erro. A mensagem impressa subsequente contém essa sequência, a : (Colon), e uma explicação do erro.