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.65 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> ».