std::basic_filebuf<CharT,Traits>:close

 

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)

 

std::basic_filebuf

Öffentliche Memberfunktionen

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

Geschützte Memberfunktionen

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

Nicht-Member-Funktionen

swap(std::basic_filebuf) (C++11)

 

std::basic_filebuf<CharT, Traits>* close();

Wenn ein Ausgabebereich existiert (z. B. die Datei zum Schreiben geöffnet wurde), wird zuerst overflow(Traits::eof()) aufgerufen, um alle ausstehenden Ausgaben in die Datei zu schreiben, einschließlich aller Unshift-Sequenzen.

Wenn die zuletzt aufgerufene Funktion aus underflow(), overflow(), seekpos() und seekoff() overflow() war, wird dann std::codecvt::unshift() aufgerufen, möglicherweise mehrmals, um die Unshift-Sequenz gemäß der eingebetteten Locale zu ermitteln und diese Sequenz mit overflow(Traits::eof()) in die Datei zu schreiben.

Dann wird die Datei geschlossen, als ob std::fclose() aufgerufen worden wäre, unabhängig davon, ob einer der vorhergehenden Aufrufe erfolgreich war oder fehlschlug.

Wenn einer der aufgerufenen Funktionsaufrufe, einschließlich des Aufrufs von std::fclose(), fehlschlägt, wird ein Nullzeiger zurückgegeben. Wenn einer der aufgerufenen Funktionsaufrufe eine Ausnahme auslöst, wird die Ausnahme abgefangen und nach dem Schließen der Datei erneut ausgelöst. Wenn die Datei bereits geschlossen ist, wird sofort ein Nullzeiger zurückgegeben.

In jedem Fall wird die private Membervariable aktualisiert, auf die von is_open() zugegriffen wird.

Parameter

(keine)

Rückgabewert

this bei Erfolg, ein Nullzeiger bei Fehler.

Hinweise

close() wird typischerweise über den Destruktor von std::basic_filebuf aufgerufen (der wiederum typischerweise vom Destruktor von std::basic_fstream aufgerufen wird).

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 443	C++98	die Datei wurde mit overflow(EOF) geschrieben	wurde zu overflow(Traits::eof()) geändert
LWG 622	C++98	war unklar, wie damit umzugehen ist eine Ausnahme beim Schließen	sie wird nach dem Schließen der Datei erneut ausgelöst

Siehe auch

is_open	prüft, ob die zugeordnete Datei geöffnet ist (public member function)
(Destruktor) [virtuell]	destruiert ein basic_filebuf Objekt und schließt die Datei, falls sie geöffnet ist (virtual public member function)