NOM
error, error_at_line, error_message_count, error_on_per_line,
error_print_progname - Fonctions de compte-rendu d’erreurs de la glibc
SYNOPSIS
#include <error.h>
void error(int status, int errnum, const char *format, ...);
void error_at_line(int status, int errnum, const char *filename,
unsigned int linenum, const char *format, ...);
extern unsigned int error_message_count;
extern int error_one_per_line;
extern void (* error_print_progname) (void);
error() est une fonction générique de rapport d’erreurs. Elle vide
stdout, et affiche sur stderr, le nom du programme, « : », une espace
et le message spécifié par la chaîne format dans le format printf(3) et
si errnum est différent de zéro, « : » suivi d’une espace avec le
contenu de perror(errnum). Tout argument de format doit suivre format
dans la liste des arguments. L’affichage se termine par un retour à la
ligne.
Le nom du programme affiché par error() est la valeur de la variable
globale program_invocation_name(3). program_invocation_name est
initialisée à la même valeur que l’argument argv[0] de la fonction
main(). La valeur de cette variable peut être modifiée pour changer
l’affichage de error().
Si status possède une valeur non nulle, alors error() appelle exit(3)
afin de terminer le programme avec la valeur de retour donnée.
La fonction error_at_line() est identique à error(), excepté les
arguments supplémentaires filename et linenum. L’affichage produit est
similaire à celui de error(), excepté qu’après le nom du programme sont
écrits « : », la valeur de filename, « : » et la valeur de linenum. Les
paramètres __LINE__ et __FILE__ du préprocesseur peuvent être utiles
lors de l’utilisation de error_at_line(), mais d’autres valeurs peuvent
aussi être utilisées. Par exemple, ces arguments peuvent faire
référence à l’emplacement dans un fichier.
Si la variable globale error_one_per_line est définie à une valeur non
nulle, une séquence d’appels à error_at_line() avec les mêmes valeurs
de filename et linenum ne produira qu’un seul message de sortie (le
premier).
La variable globale error_message_count compte le nombre de messages
qui ont été affichés avec error() et error_at_line().
Si la variable globale error_print_progname est assignée à l’adresse
d’une fonction (c’est-à-dire, différent de NULL), alors cette fonction
est appelée au lieu de préfixer le message avec le nom du programme et
« :». La fonction doit affiché une chaîne de caractère sur stderr.
CONFORMITÉ
Ces fonctions et ces variables sont des extensions GNU et ne doivent
pas être utilisées pour des applications portables.
VOIR AUSSI
err(3), errno(3), exit(3), perror(3), program_invocation_name(3),
strerror(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».