Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

clearerr — funzione di stato dello stream C23

`clearerr(stream)` di `<stdio.h>` cancella sia l’indicatore di fine file sia quello di errore dello stream `FILE` indicato; non restituisce valori. Non esegue operazioni di input o output.

Versione: C23

Sintassi

void clearerr(FILE *stream);

clearerr(stream) di <stdio.h> cancella sia l’indicatore di fine file sia quello di errore dello stream FILE indicato; non restituisce valori. Non esegue operazioni di input o output.

Usala prima di tentare consapevolmente altro I/O dopo aver gestito EOF o un errore. L’esempio legge oltre l’unico carattere di un tmpfile(), osserva feof = 1 e ferror = 0, chiama clearerr e poi osserva 0 0.

clearerr non sposta la posizione, non elimina dati bufferizzati e non ripete l’operazione fallita; I/O successivo può impostare ancora gli indicatori. stream deve puntare a un oggetto FILE valido e vivo, e la diagnosi deve distinguere feof da ferror.

Esempi

#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;
}

Risultato

1 0 0 0

Usala prima di tentare consapevolmente altro I/O dopo aver gestito EOF o un errore. L’esempio legge oltre l’unico carattere di un `tmpfile()`, osserva `feof = 1` e `ferror = 0`, chiama `clearerr` e poi osserva `0 0`.

Fonti