error

ERROR(3)                  Manuel du programmeur Linux                 ERROR(3)



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.

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.70 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 Ã
       <perkamon-fr@traduc.org>.

       Vous pouvez toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».



GNU                              29 août 2010                        ERROR(3)