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

CKTIS / C

clearerr — fonction d’état de flux C23

`clearerr(stream)` de `<stdio.h>` efface à la fois l’indicateur de fin de fichier et l’indicateur d’erreur du flux `FILE` indiqué ; elle ne renvoie rien. Elle n’effectue aucune entrée-sortie.

Version : C23

Syntaxe

void clearerr(FILE *stream);

clearerr(stream) de <stdio.h> efface à la fois l’indicateur de fin de fichier et l’indicateur d’erreur du flux FILE indiqué ; elle ne renvoie rien. Elle n’effectue aucune entrée-sortie.

Utilisez-la avant de tenter sciemment d’autres E/S après avoir traité EOF ou une erreur. L’exemple lit au-delà de l’unique caractère d’un tmpfile(), observe feof = 1 et ferror = 0, appelle clearerr, puis observe 0 0.

clearerr ne déplace pas la position, ne supprime pas les données tamponnées et ne répète pas l’opération échouée ; des E/S ultérieures peuvent rétablir les indicateurs. stream doit désigner un objet FILE valide et vivant, et le diagnostic doit distinguer feof de ferror.

Exemples

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    fputs("A", stream);
    rewind(stream);
    (void)fgetc(stream);
    (void)fgetc(stream);
    printf("%d %d ", feof(stream) != 0, ferror(stream) != 0);
    clearerr(stream);
    printf("%d %d\n", feof(stream) != 0, ferror(stream) != 0);
    fclose(stream);
    return 0;
}

Résultat

1 0 0 0

Utilisez-la avant de tenter sciemment d’autres E/S après avoir traité EOF ou une erreur. L’exemple lit au-delà de l’unique caractère d’un `tmpfile()`, observe `feof = 1` et `ferror = 0`, appelle `clearerr`, puis observe `0 0`.

Sources