error(3) Library Functions Manual 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 BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include void error(int statut, int numerr, const char *format, ...); void error_at_line(int statut, int numerr, const char *nomfichier, unsigned int numligne, 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 numerr est different de zero, un second caractere deux-points, une espace suivie du contenu de strerror(numerr). 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 statut possede une valeur non nulle, alors error() appelle exit(3) afin de terminer le programme avec la valeur de retour donnee. Sinon il renvoie apres avoir affiche le message d'erreur. La fonction error_at_line() est identique a error() excepte les arguments supplementaires nomfichier et numligne. L'affichage produit est similaire a celui de error() excepte qu'apres le nom du programme sont ecrits << : >>, la valeur de nomfichier, << : >> et la valeur de numligne. 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 d'entree. 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 nomfichier et numligne 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 afficher une chaine adaptee sur stderr. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +----------------+--------------------------+--------------------------+ |Interface | Attribut | Valeur | +----------------+--------------------------+--------------------------+ |error() | Securite des threads | MT-Safe locale | +----------------+--------------------------+--------------------------+ |error_at_line() | Securite des threads | MT-Unsafe race: | | | | error_at_line/ | | | | error_one_per_line | | | | locale | +----------------+--------------------------+--------------------------+ La variable interne error_one_per_line est accedee (sans aucune forme de synchronisation mais, puisque c'est un int qui n'est utilise qu'une seule fois, de facon plutot sure) et si error_one_per_line n'est pas defini a zero, les variables internes statiques (pas exposees a l'utilisateur) utilisees pour stocker le dernier nom de fichier affiche ainsi que le numero de ligne sont accedees et modifiees sans synchronisation ; la mise a jour n'est pas atomique et survient avant la desactivation de l'annulation et peut donc etre interrompue seulement apres qu'une des deux variables soit modifiee. Apres cela, error_at_line() est tres similaire a error(). STANDARDS GNU. VOIR AUSSI err(3), errno(3), exit(3), perror(3), program_invocation_name(3), strerror(3) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Gregoire Scano Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.8 2 mai 2024 error(3)