NOM¶
error, error_at_line, error_message_count, error_one_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);
DESCRIPTION¶
error() est une fonction générique de rapport d'erreurs. Elle
vide
stdout, et affiche sur
stderr, le nom du programme, un
caractère deux-points, une espace, le message spécifié par la
chaîne
format dans le format
printf(3) et si
errnum
est différent de zéro, un second caractère deux-points, une
espace suivie du contenu de
strerror(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.
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.44 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¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et
l'équipe francophone de traduction de Debian (2006-2009).
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> ».