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

CKTIS / C

ferror — fonction de flux C23

`ferror(stream)` de `<stdio.h>` teste l’indicateur d’erreur d’un flux `FILE` ouvert. Elle renvoie une valeur non nulle si et seulement si l’indicateur est posé ; elle n’effectue aucune E/S, ne fournit pas un code d’erreur précis et ne modifie pas l’état du flux.

Version : C23

Syntaxe

int ferror(FILE *stream);

ferror(stream) de <stdio.h> teste l’indicateur d’erreur d’un flux FILE ouvert. Elle renvoie une valeur non nulle si et seulement si l’indicateur est posé ; elle n’effectue aucune E/S, ne fournit pas un code d’erreur précis et ne modifie pas l’état du flux.

L’exemple lit au-delà de l’unique caractère d’un tmpfile(). 1 0 0 montre que fgetc a renvoyé EOF à cause de la fin, que ferror est resté nul et que clearerr a effacé les deux indicateurs.

Le retour EOF d’une fonction d’entrée est ambigu : seuls feof et ferror distinguent fin des données et erreur de lecture. ferror n’efface pas l’indicateur et ne donne pas la cause système ; préservez un errno utile et appelez clearerr avant une nouvelle tentative voulue. stream doit désigner un flux ouvert valide.

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);
    (void)fgetc(stream);
    int at_end = fgetc(stream) == EOF && feof(stream) != 0;
    int failed = ferror(stream) != 0;
    clearerr(stream);
    printf("%d %d %d\n", at_end, failed, feof(stream) != 0 || ferror(stream) != 0);
    return fclose(stream) == 0 ? 0 : 1;
}

Résultat

1 0 0

L’exemple lit au-delà de l’unique caractère d’un `tmpfile()`. `1 0 0` montre que `fgetc` a renvoyé `EOF` à cause de la fin, que `ferror` est resté nul et que `clearerr` a effacé les deux indicateurs.

Sources