clearerr, feof, ferror - Vérifier et réinitialiser l'état
d'un flux
Bibliothèque C standard (
libc,
-lc)
#include <stdio.h>
void clearerr(FILE *flux);
int feof(FILE *flux);
int ferror(FILE *flux);
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).
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.
Ces fonctions ne doivent pas échouer et n'affectent pas de valeur
à
errno.
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 |
Les fonctions
clearerr(),
feof() et
ferror() sont conformes
à C99, POSIX.1-2001 et POSIX.1-2008.
POSIX.1-2008 stipule que ces fonctions ne doivent pas changer la valeur de
errno si
flux est valable.
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).
open(2),
fdopen(3),
fileno(3),
stdio(3),
unlocked_stdio(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
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]>,
Frédéric Hantrais <
[email protected]> et Lucien Gentis
<
[email protected]>
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 à
[email protected]