Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

feof — fonction de flux C23

`feof(stream)` de `<stdio.h>` teste l’indicateur de fin de fichier d’un flux `FILE` ouvert. Elle renvoie une valeur non nulle si et seulement si cet indicateur est posé ; elle ne lit rien et ne renvoie pas elle-même la constante `EOF`.

Version : C23

Syntaxe

int feof(FILE *stream);

feof(stream) de <stdio.h> teste l’indicateur de fin de fichier d’un flux FILE ouvert. Elle renvoie une valeur non nulle si et seulement si cet indicateur est posé ; elle ne lit rien et ne renvoie pas elle-même la constante EOF.

L’exemple écrit un caractère dans un tmpfile(), rembobine, lit le caractère et observe feof == 0. Seul le fgetc suivant renvoie EOF et pose l’indicateur ; 0 1 0 0 montre aussi l’absence d’erreur et l’état effacé par clearerr.

feof ne prédit pas la fin : une boucle doit d’abord tester le retour de l’opération d’entrée, puis employer feof et ferror pour diagnostiquer l’arrêt. Lire correctement le dernier octet ne pose pas encore l’indicateur. stream doit être un flux ouvert valide ; clearerr, rewind et un repositionnement réussi peuvent effacer l’état EOF.

Exemples

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputc('A', stream) == EOF) { fclose(stream); return 1; }
    rewind(stream);
    if (fgetc(stream) != 'A') { fclose(stream); return 1; }
    int before = feof(stream) != 0;
    if (fgetc(stream) != EOF) { fclose(stream); return 1; }
    int after = feof(stream) != 0;
    int failed = ferror(stream) != 0;
    clearerr(stream);
    printf("%d %d %d %d\n", before, after, failed, feof(stream) != 0);
    return fclose(stream) == 0 ? 0 : 1;
}

Résultat

0 1 0 0

L’exemple écrit un caractère dans un `tmpfile()`, rembobine, lit le caractère et observe `feof == 0`. Seul le `fgetc` suivant renvoie `EOF` et pose l’indicateur ; `0 1 0 0` montre aussi l’absence d’erreur et l’état effacé par `clearerr`.

Sources