Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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)