man fpurge (Fonctions bibliothèques) - Purger un flux
NOM
fpurge, __fpurge - Purger un flux
SYNOPSIS
/* non supporté */ #include <stdio.h> int fpurge(FILE *stream); /* supporté */ #include <stdio.h>
#include <stdio_ext.h> void __fpurge(FILE *stream);
DESCRIPTION
La fonction fpurge() efface les tampons d'un flux donné. Pour les flux de sortie, on se débarrasse de toute sortie n'ayant pas encore été écrite. Pour les flux d'entrée, on renonce à toute entrée lue par l'objet sous-jacent mais n'ayant pas encore été acquise par getc(3); Cela inclut tout texte ré-injecté dans le flux par ungetc(). Voir aussi fflush(3).
La fonction __fpurge() fait exactement la même chose mais n'a pas de code de retour.
VALEUR RENVOYÉE
En cas de succès, fpurge() renvoie 0. En cas d'erreur, elle renvoie -1 et positionne errno de façon adéquate.
ERREURS
- EBADF
- stream ne correspond pas à un flux ouvert.
CONFORMITÉ
Ces fonctions ne sont ni standards ni portables. La fonction fpurge() a été introduite sous BSD 4.4 et n'est pas disponible sous Linux. La fonction __fpurge() a été introduite sous solaris, et se trouve dans la glibc 2.1.95 et ses versions ultérieures.
NOTES
Vouloir purger des tampons d'entrée constitue généralement une erreur.
VOIR AUSSI
TRADUCTION
Stéphan Rafin, 2002.