FERROR(3)

NOM
ferror, clearerr, 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 fonctionalité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 concernant le 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 concernant le 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() renvoie le descripteur de fichier, de type entier, correspondant au flux stream.

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 remplir 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 19 décembre 2007.

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.