CKTIS / C
fflush — funzione di flusso C23
`fflush(stream)` di `<stdio.h>` consegna all’ambiente host i dati di output bufferizzati non scritti di uno stream di output o aggiornamento idoneo. `fflush(NULL)` lo tenta per tutti tali stream aperti; restituisce zero al successo o `EOF` con indicatore di errore impostato al fallimento.
Versione: C23
Sintassi
int fflush(FILE *stream);fflush(stream) di <stdio.h> consegna all’ambiente host i dati di output bufferizzati non scritti di uno stream di output o aggiornamento idoneo. fflush(NULL) lo tenta per tutti tali stream aperti; restituisce zero al successo o EOF con indicatore di errore impostato al fallimento.
L’esempio scrive hello in un tmpfile(), chiama fflush, riavvolge e legge con fgets. 1 hello mostra uno scaricamento riuscito e una transizione valida dalla scrittura alla lettura su uno stream di aggiornamento.
Il C standard non definisce fflush(stdin) per scartare input: se lo stream non soddisfa la condizione output/aggiornamento, il comportamento è indefinito. Successo significa consegna all’ambiente, non necessariamente persistenza fisica. Controlla EOF; dopo un errore l’indicatore resta impostato fino a un’operazione che lo azzeri, come clearerr o rewind.
Esempi
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputs("hello", stream) == EOF) { fclose(stream); return 1; }
int flushed = fflush(stream) == 0;
rewind(stream);
char buffer[6];
if (fgets(buffer, sizeof buffer, stream) == NULL) { fclose(stream); return 1; }
printf("%d %s\n", flushed, buffer);
return fclose(stream) == 0 ? 0 : 1;
}
Risultato
1 hello
L’esempio scrive `hello` in un `tmpfile()`, chiama `fflush`, riavvolge e legge con `fgets`. `1 hello` mostra uno scaricamento riuscito e una transizione valida dalla scrittura alla lettura su uno stream di aggiornamento.