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
C11, POSIX.1-2008.

HISTORIQUE
C89, POSIX.1-2001.

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.