Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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);
DESCRIPTION
error() est une fonction generique de rapport d'erreurs. Elle vide
stdout, et affiche sur stderr, le nom du programme, un caractere
deux-points, une espace, le message specifie par la chaine format dans
le format printf(3) et si errnum est different de zero, un second
caractere 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 a la ligne.
Le nom du programme affiche par error() est la valeur de la variable
globale program_invocation_name(3). program_invocation_name est
initialisee a la meme valeur que l'argument argv[0] de la fonction
main(). La valeur de cette variable peut etre modifiee pour changer
l'affichage de error().
Si status possede une valeur non nulle, alors error() appelle exit(3)
afin de terminer le programme avec la valeur de retour donnee.
La fonction error_at_line() est identique a error(), excepte les
arguments supplementaires filename et linenum. L'affichage produit est
similaire a celui de error(), excepte qu'apres le nom du programme sont
ecrits << : >>, la valeur de filename, << : >> et la valeur de linenum.
Les parametres __LINE__ et __FILE__ du preprocesseur peuvent etre
utiles lors de l'utilisation de error_at_line(), mais d'autres valeurs
peuvent aussi etre utilisees. Par exemple, ces arguments peuvent faire
reference a l'emplacement dans un fichier.
Si la variable globale error_one_per_line est definie a une valeur non
nulle, une sequence d'appels a error_at_line() avec les memes 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 ete affiches avec error() et error_at_line().
Si la variable globale error_print_progname est assignee a l'adresse
d'une fonction (c'est-a-dire, different de NULL), alors cette fonction
est appelee au lieu de prefixer le message avec le nom du programme et
<< : >>. La fonction doit affiche une chaine de caractere sur stderr.
CONFORMIT'E
Ces fonctions et ces variables sont des extensions GNU et ne doivent
pas etre utilisees 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.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Florentin
Duneau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
GNU 29 aout 2010 ERROR(3)