Provided by: manpages-fr-dev_3.17.1-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 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.17 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> ».