NOM¶

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¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <error.h>

void error(int status, int errnum, const char *format, ...);
void error_at_line(int status, int errnum, const char *file,
                   unsigned int line, const char *format, ...);

extern unsigned int error_message_count;
extern int error_one_per_line;

extern typeof(void (void))  *error_print_progname;

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 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.

The error_at_line() function is exactly the same as error(), except for the addition of the arguments file and line. The output produced is as for error(), except that after the program name are written: a colon, the value of file, a colon, and the value of line. The preprocessor values __LINE__ and __FILE__ may be useful when calling error_at_line(), but other values can also be used. For example, these arguments could refer to a location in an input file.

If the global variable error_one_per_line is set nonzero, a sequence of error_at_line() calls with the same value of file and line will result in only one message (the first) being output.

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.

ATTRIBUTS¶

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

La variable interne error_one_per_line est accédée (sans aucune forme de synchronisation mais, puisque c'est un int qui n'est utilisé qu'une seule fois, de façon plutôt sûre) et si error_one_per_line n'est pas défini à zéro, les variables internes statiques (pas exposées à l'utilisateur) utilisées pour stocker le dernier nom de fichier affiché ainsi que le numéro de ligne sont accédées et modifiées sans synchronisation ; la mise à jour n'est pas atomique et survient avant la désactivation de l'annulation et peut donc être interrompue seulement après qu'une des deux variables soit modifiée. Après cela, error_at_line() est très similaire à error().

STANDARDS¶

GNU.

VOIR AUSSI¶

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

TRADUCTION¶

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.