sous-routine perror

Objectif

Ecrit un message expliquant une erreur de sous-routine.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

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

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

Descriptif

La sous-routine perror écrit un message dans la sortie d'erreur standard qui décrit la dernière erreur rencontrée par un appel système ou une sous-routine de bibliothèque. Le message d'erreur inclut la chaîne de paramètre String suivie d'un: (Colon), d'un espace, du message et d'un caractère de nouvelle ligne. La chaîne de paramètre String doit inclure le nom du programme à l'origine de l'erreur. Le numéro d'erreur provient de la variable globale errno , qui est définie lorsqu'une erreur se produit, mais qui n'est pas effacée lorsqu'un appel réussi à la sous-routine perror est effectué.

Pour simplifier les différents formats de message, un tableau de chaînes de message est fourni dans la structure sys_errlist ou utilisez la variable globale errno comme index dans la structure sys_errlist pour obtenir la chaîne de message sans le caractère de nouvelle ligne. Le numéro de message le plus élevé fourni dans la table est sys_nerr. Veillez à vérifier la structure sys_nerr car de nouveaux codes d'erreur peuvent être ajoutés au système avant qu'ils ne soient ajoutés à la table.

La sous-routine perror extrait un message d'erreur en fonction de la langue de l'environnement local en cours.

Une fois l'opération terminée, et avant un appel à la sous-routine exit ou abort ou à la fin de la sous-routine fflush ou fclose sur le flux d'erreur standard, la sous-routine perror marque la mise à jour des zones st_ctime et st_mtime du fichier associé au flux d'erreur standard.

Paramètre

Tableau 1. Paramètre
Article Descriptif
String Indique une chaîne de paramètres contenant le nom du programme à l'origine de l'erreur. Le message imprimé qui suit contient cette chaîne, a : (Colon), et une explication de l'erreur.