CKTIS / C
fflush — C23-streamfunctie
`fflush(stream)` uit `<stdio.h>` levert ongeschreven gebufferde uitvoer van een uitvoerstream of geschikte updatestream aan de hostomgeving. `fflush(NULL)` probeert dit voor alle dergelijke open streams; resultaat is nul bij succes of `EOF` met gezette foutindicator bij mislukking.
Versie: C23
Syntax
int fflush(FILE *stream);fflush(stream) uit <stdio.h> levert ongeschreven gebufferde uitvoer van een uitvoerstream of geschikte updatestream aan de hostomgeving. fflush(NULL) probeert dit voor alle dergelijke open streams; resultaat is nul bij succes of EOF met gezette foutindicator bij mislukking.
Het voorbeeld schrijft hello naar een tmpfile(), roept fflush aan, spoelt terug en leest met fgets. 1 hello toont succesvol spoelen en een geldige overgang van schrijven naar lezen op een updatestream.
Standaard-C definieert fflush(stdin) niet om invoer te verwijderen: voldoet de stream niet aan de uitvoer/updatevoorwaarde, dan is gedrag ongedefinieerd. Succes betekent levering aan de hostomgeving, niet noodzakelijk duurzame opslag. Test EOF; na mislukking blijft de foutindicator gezet tot een wisbewerking zoals clearerr of rewind.
Voorbeelden
#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;
}
Resultaat
1 hello
Het voorbeeld schrijft `hello` naar een `tmpfile()`, roept `fflush` aan, spoelt terug en leest met `fgets`. `1 hello` toont succesvol spoelen en een geldige overgang van schrijven naar lezen op een updatestream.