====== fflush() ======

''fflush()'' ist in der ''[[c:lib:stdio:start|stdio]]'' definiert, die in C über ''stdio.h'', bzw in C++ über ''cstdio'' eingebunden wird.

===== Funktion =====

''fflush()'' wird dazu verwendet, den Puffer eines Streams in den Stream zu sichern.\\ 
Streams werden in der Regel zwischengepuffert, um möglichst viele Daten am Stück zu übertragen, statt Buchstabe für Buchstabe zu übertragen. Daher wird mit der Übertragung oftmals gewartet, bis ein Block voll oder eine Zeile abgeschlossen ist. 
Damit kann eine sofortige Ausgabe erzwungen werden, zum Beispiel, um eine Ausgabe auf dem Bildschirm zu erlangen, obwohl die Zeile nicht mit einem Newline-Zeichen abgeschlossen wurde.

===== Signatur =====

<code cpp>#include <stdio.h>
int fflush( FILE * file );</code>

**file**: Stream, dessen Puffer übertragen werden soll \\
\\
**Return Value**: 0 im Erfolgsfall, ansonsten EOF und ''[[c:lib:errno:errno]]'' wird gesetzt.

===== Fehlerquellen =====
-

===== Beispiel =====

Der folgende Code wird ähnlich verwendet bei ''[[setvbuf()]]'', welches den Zwischenpuffer abschaltet, so dass ''fflush()'' nicht mehr notwendig ist.
<code cpp>
#include <stdlib.h>
#include <stdio.h>

int main (void)
{
  FILE *file = fopen("logfile.txt", "w+");
  
  fprintf( file, "vor Absturz" );
  /* Kommentar in der nächsten Zeile entfernen, um zuverlässig Logfiles zu schreiben */
  // fflush( file ); 
   
  /* Absturz provozieren */ 
  *((int *)0) = 4711;

  /* Dieser Part wird nicht mehr erreicht */
  fprintf( file, "nach Absturz" );
 
  fclose(file);
  return EXIT_SUCCESS;
}</code>


===== siehe auch =====

[[c:lib:stdio:start|stdio]]: [[c:lib:stdio:setbuf()]], [[c:lib:stdio:setvbuf()]]