FERROR

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 26 juillet 2007
Index Menu principal

NOM

clearerr, ferror, feof, fileno - Vérifier et réinitialiser les états d'un flux

SYNOPSIS

#include <stdio.h>

void clearerr(FILE *stream);

int feof(FILE *stream);

int ferror(FILE *stream);

int fileno(FILE *stream);

Exigences de macros de test de fonctionnalités pour la glibc (voir feature_test_macros(7)) :

fileno() : _POSIX_C_SOURCE || _XOPEN_SOURCE

DESCRIPTION

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

La fonction feof() teste l'indicateur de fin de fichier du flux pointé par stream, et renvoie une valeur non nulle 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 stream, et envoie une valeur non nulle si cet indicateur est actif. L'indicateur d'erreur ne peut être réinitialisé que par la fonction clearerr().

La fonction fileno() examine l'argument stream et renvoie le descripteur de fichier, de type entier.

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

ERREURS

Ces fonctions ne devraient pas échouer, et ne définissent donc pas la variable errno. (Toutefois, si fileno() détecte que son argument n'est pas un flux valide, il doit renvoyer -1 et renseigner errno avec EBADF.)

CONFORMITÉ

Les fonctions clearerr(), feof(), et ferror() sont conformes à C89 et C99.

VOIR AUSSI

open(2), fdopen(3), stdio(3), unlocked_stdio(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 23 octobre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 ferror ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008