Scroll to navigation

ferror(3) Library Functions Manual ferror(3)

NOM

clearerr, feof, ferror - Vérifier et réinitialiser l'état d'un flux

BIBLIOTHÈQUE

Bibliothèque C standard (libc, -lc)

SYNOPSIS

#include <stdio.h>
void clearerr(FILE *flux);
int feof(FILE *flux);
int ferror(FILE *flux);

DESCRIPTION

La fonction clearerr() efface les indicateurs d'erreur et de fin de fichier du flux pointé par flux.

La fonction feof() teste l'indicateur de fin de fichier du flux pointé par flux et renvoie une valeur différente de zéro si cet indicateur est actif. L'indicateur de fin de fichier ne peut être réinitialisé que par la fonction clearerr().

La fonction ferror() teste l'indicateur d'erreur du flux pointé par flux, et renvoie une valeur différente de zéro si cet indicateur est actif. L'indicateur d'erreur ne peut être réinitialisé que par la fonction clearerr().

Pour des versions de ces fonctions ignorant les verrouillages, voir unlocked_stdio(3).

VALEUR RENVOYÉE

La fonction feof() renvoie une valeur différente de zéro si l'indicateur de fin de fichier est actif pour le flux flux ; dans le cas contraire, elle renvoie zéro.

La fonction ferror() renvoie une valeur différente de zéro si l'indicateur d'erreur est actif pour le flux flux ; dans le cas contraire, elle renvoie zéro.

ERREURS

Ces fonctions ne doivent pas échouer et n'affectent pas de valeur à errno.

ATTRIBUTS

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

Interface Attribut Valeur
clearerr(), feof(), ferror() Sécurité des threads MT-Safe

STANDARDS

Les fonctions clearerr(), feof() et ferror() sont conformes à C99, POSIX.1-2001 et POSIX.1-2008.

NOTES

POSIX.1-2008 stipule que ces fonctions ne doivent pas changer la valeur de errno si flux est valable.

AVERTISSEMENT

Normalement les programmes devraient lire la valeur renvoyée par une fonction d'entrée telle que fgetc(3) avant d'utiliser les fonctions de la famille de feof(3). C'est uniquement lorsque la fonction renvoie la valeur sentinelle EOF que cela a un sens de faire une distinction entre la fin d'un fichier d'une erreur avec feof(3) ou ferror(3).

VOIR AUSSI

open(2), fdopen(3), fileno(3), stdio(3), unlocked_stdio(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>, Frédéric Hantrais <fhantrais@gmail.com> et Lucien Gentis <lucien.gentis@waika9.com>

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.

29 décembre 2022 Pages du manuel de Linux 6.03