std::fflush

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

C-Style I/O

Typen und Objekte
FILE fpos_t	stdinstdoutstderr
Funktionen
Datei-Zugriff fopen freopen fclose fflush fwide setbuf setvbuf Direkte Ein-/Ausgabe fread fwrite Unformatierte Ein-/Ausgabe fgetcgetc fgets fputcputc fputs getchar gets (bis C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc Formatierte Eingabe scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	Formatierte Ausgabe printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove rename tmpfile tmpnam

 

Definiert in Header <cstdio>
int fflush( std::FILE* stream );

Schreibt für Ausgabeströme (und für Update-Ströme, bei denen die letzte Operation eine Ausgabe war) alle ungeschriebenen Daten aus dem Puffer des stream in das zugehörige Ausgabegerät.

Für Eingabeströme (und für Update-Ströme, bei denen die letzte Operation eine Eingabe war) ist das Verhalten undefiniert.

Wenn Daten an ein Ausgabegerät geschrieben werden, stellt die Rückkehr aus std::fflush einen beobachtbaren Prüfpunkt dar.

(seit C++26)

Wenn stream ein Nullzeiger ist, werden die oben beschriebenen Spülvorgänge für alle offenen Ausgabeströme durchgeführt, einschließlich derjenigen, die innerhalb von Bibliothekspaketen manipuliert werden oder dem Programm sonst nicht direkt zugänglich sind.

Parameter

stream

-

Der Dateistrom, der ausgegeben werden soll

Rückgabewert

Gibt bei Erfolg ​0​ zurück. Andernfalls wird EOF zurückgegeben und der Fehlerindikator des Dateistroms gesetzt.

Anmerkungen

POSIX erweitert die Spezifikation von fflush, indem seine Auswirkungen auf einen Eingabestrom definiert werden, solange dieser Strom eine Datei oder ein anderes suchbares Gerät repräsentiert: In diesem Fall wird der POSIX-Dateizeiger so repositioniert, dass er mit dem C-Stream-Zeiger übereinstimmt (was jegliches Lesen aus dem Puffer rückgängig macht) und die Auswirkungen von std::ungetc oder std::ungetwc, die noch nicht aus dem Strom zurückgelesen wurden, verworfen.

Microsoft erweitert ebenfalls die Spezifikation von fflush, indem seine Auswirkungen auf einen Eingabestrom definiert werden: In Visual Studio 2013 und früher wurde der Eingabepuffer verworfen, in Visual Studio 2015 und neuer hat er keine Auswirkung, Puffer werden beibehalten.

Siehe auch

fopen	öffnet eine Datei (function)
fclose	schließt eine Datei (function)
C-Dokumentation für fflush