error(3) Library Functions Manual error(3)

error, error_at_line, error_message_count, error_one_per_line, error_print_progname - Fonctions de compte-rendu d'erreurs de la glibc

Bibliothèque C standard (libc, -lc)

#include <error.h>
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);

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 numerr est différent de zéro, un second caractère 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 à 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 statut possède une valeur non nulle, alors error() appelle exit(3) afin de terminer le programme avec la valeur de retour donnée. Sinon il renvoie après avoir affiché le message d'erreur.

La fonction error_at_line() est identique à error() excepté les arguments supplémentaires nomfichier et numligne. L'affichage produit est similaire à celui de error() excepté qu'après le nom du programme sont écrits « : », la valeur de nomfichier, « : » et la valeur de numligne. 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 d’entrée.

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 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 é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 afficher une chaîne adaptée sur stderr.

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

Interface Attribut Valeur
error() Sécurité des threads MT-Safe locale
error_at_line() Sécurité des threads MT-Unsafe race: error_at_line/error_one_per_line locale

The internal error_one_per_line variable is accessed (without any form of synchronization, but since it's an int used once, it should be safe enough) and, if error_one_per_line is set nonzero, the internal static variables (not exposed to users) used to hold the last printed filename and line number are accessed and modified without synchronization; the update is not atomic and it occurs before disabling cancelation, so it can be interrupted only after one of the two variables is modified. After that, error_at_line() is very much like error().

Ces fonctions et ces variables sont des extensions GNU et ne doivent pas être utilisées pour des applications portables.

err(3), errno(3), exit(3), perror(3), program_invocation_name(3), strerror(3)

La traduction française de cette page de manuel a été créée par Christophe Blaess https://www.blaess.fr/christophe/, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Grégoire Scano <gregoire.scano@malloc.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.

15 décembre 2022 Pages du manuel de Linux 6.02