ferror

Section: C Library Functions (3)
Updated: 29 décembre 2022
Index Return to Main Contents
 

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).
InterfaceAttributValeur
clearerr(), feof(), ferror() Sécurité des threadsMT-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 à


 

Index

NOM
BIBLIOTHÈQUE
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
ATTRIBUTS
STANDARDS
NOTES
AVERTISSEMENT
VOIR AUSSI
TRADUCTION

This document was created by man2html, using the manual pages.
Time: 06:49:23 GMT, May 18, 2024