std::basic_filebuf

 

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)

 

Definiert in Header <fstream>
template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_filebuf : public std::basic_streambuf<CharT, Traits>

std::basic_filebuf ist ein std::basic_streambuf, dessen zugeordnete Zeichensequenz eine Datei ist. Sowohl die Eingabesequenz als auch die Ausgabesequenz sind mit derselben Datei verknüpft, und für beide Operationen wird eine gemeinsame Dateiposition beibehalten. Die Einschränkungen für das Lesen und Schreiben einer Sequenz mit std::basic_filebuf sind dieselben wie für std::FILEs.

Die Funktionen underflow() und overflow() / sync() führen die eigentliche I/O zwischen der Datei und den Lese- und Schreibbereichen des Puffers durch. Wenn CharT nicht char ist, speichern die meisten Implementierungen Multibyte-Zeichen in der Datei und eine std::codecvt Facette wird zur Konvertierung von Wide-/Multibyte-Zeichen verwendet.

Mehrere Typedefs für gängige Zeichentypen werden bereitgestellt

Definiert in Header <fstream>
Typ	Definition
std::filebuf	std::basic_filebuf<char>
std::wfilebuf	std::basic_filebuf<wchar_t>

Member types

Typ	Definition
char_type	CharT
traits_type	Traits; das Programm ist fehlerhaft, wenn Traits::char_type nicht CharT ist.
int_type	Traits::int_type
pos_type	Traits::pos_type, was std::fpos<Traits::state_type> sein muss
off_type	Traits::off_type
native_handle_type(C++26)	implementierungsabhängiger Typ, der TriviallyCopyable und semiregular ist

Member functions

Öffentliche Memberfunktionen
(Konstruktor)	konstruiert ein basic_filebuf Objekt (public member function)
operator= (C++11)	weist ein basic_filebuf Objekt zu (public member function)
swap (C++11)	tauscht zwei basic_filebuf Objekte (public member function)
native_handle (C++26)	gibt den zugrundeliegenden implementierungsabhängigen Handle zurück (public member function)
(Destruktor) [virtuell]	destruiert ein basic_filebuf Objekt und schließt die Datei, falls sie geöffnet ist (virtual public member function)
is_open	prüft, ob die zugeordnete Datei geöffnet ist (public member function)
open	öffnet eine Datei und konfiguriert sie als zugeordnete Zeichensequenz (public member function)
close	Leert den Ausgabepuffer und schließt die zugehörige Datei (public member function)
Geschützte Memberfunktionen
showmanyc [virtuell]	stellt optional die Anzahl der für die Eingabe aus der Datei verfügbaren Zeichen bereit (virtual protected member function)
underflow [virtuell]	liest aus der zugeordneten Datei (virtual protected member function)
uflow [virtuell]	liest aus der zugeordneten Datei und verschiebt den nächsten Zeiger im Leseberich (virtual protected member function)
pbackfail [virtuell]	macht die Eingabesequenz rückgängig, um ein Zeichen zurückzulegen, ohne die zugeordnete Datei zu beeinflussen (virtual protected member function)
overflow [virtuell]	schreibt Zeichen aus dem Schreibbereich in die zugeordnete Datei (virtual protected member function)
setbuf [virtuell]	stellt einen vom Benutzer bereitgestellten Puffer bereit oder macht diesen Filebuf unbuffered (virtual protected member function)
seekoff [virtuell]	positioniert die Dateiposition neu, unter Verwendung relativer Adressierung (virtual protected member function)
seekpos [virtuell]	positioniert die Dateiposition neu, unter Verwendung absoluter Adressierung (virtual protected member function)
sync [virtuell]	schreibt Zeichen aus dem Schreibbereich in die zugeordnete Datei (virtual protected member function)
imbue [virtuell]	ändert die zugeordnete Locale (virtual protected member function)

Non-member functions

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

spezialisiert den Algorithmus std::swap (Funktionsvorlage)

Geerbt von std::basic_streambuf

Membertypen

Mitgliedertyp	Definition
char_type	CharT
traits_type	Traits; das Programm ist fehlerhaft, wenn Traits::char_type nicht CharT ist.
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

Memberfunktionen

(Destruktor) [virtuell]	zerstört das basic_streambuf-Objekt (virtuelle öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Lokale
pubimbue	ändert die zugeordnete Locale und ruft imbue() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
getloc	holt eine Kopie der zugeordneten Locale (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Positionierung
pubsetbuf	ruft setbuf() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
pubseekoff	ruft seekoff() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
pubseekpos	ruft seekpos() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
pubsync	ruft sync() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Get-Bereich
in_avail	holt die Anzahl der im Get-Bereich sofort verfügbaren Zeichen (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
snextc	bewegt die Eingabesequenz vorwärts und liest dann ein Zeichen, ohne erneut vorzurücken (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sbumpcstossc (in C++17 entfernt)	liest ein Zeichen aus der Eingabesequenz und rückt die Sequenz vor (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sgetc	liest ein Zeichen aus der Eingabesequenz, ohne die Sequenz vorzurücken (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sgetn	ruft xsgetn() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Put-Bereich
sputc	schreibt ein Zeichen in den Put-Bereich und rückt den nächsten Zeiger vor (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sputn	ruft xsputn() auf (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
Putback
sputbackc	legt ein Zeichen zurück in die Eingabesequenz (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
sungetc	verschiebt den nächsten Zeiger in der Eingabesequenz um eins zurück (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)

Geschützte Memberfunktionen

(Konstruktor)	konstruiert ein basic_streambuf-Objekt (geschützte Member-Funktion)
operator= (C++11)	ersetzt ein basic_streambuf-Objekt (geschützte Member-Funktion)
swap (C++11)	tauscht zwei basic_streambuf-Objekte (geschützte Member-Funktion)
Lokale
imbue [virtuell]	reagiert auf eine Änderung der zugeordneten Locale (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
Positionierung
setbuf [virtuell]	ersetzt den Puffer durch ein benutzerdefiniertes Array, falls zulässig (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
seekoff [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung relativer Adressierung (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
seekpos [virtuell]	positioniert den nächsten Zeiger in der Eingabesequenz, Ausgabesequenz oder beidem neu, unter Verwendung absoluter Adressierung (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
sync [virtuell]	synchronisiert die Puffer mit der zugeordneten Zeichensequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
Get-Bereich
showmanyc [virtuell]	holt die Anzahl der für die Eingabe in der zugeordneten Eingabesequenz verfügbaren Zeichen, falls bekannt (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
underflow [virtuell]	liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
uflow [virtuell]	liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich und rückt den nächsten Zeiger vor (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
xsgetn [virtuell]	liest mehrere Zeichen aus der Eingabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
ebackgptregptr	gibt einen Zeiger auf den Anfang, das aktuelle Zeichen und das Ende des Get-Bereichs zurück (geschützte Member-Funktion)
gbump	rückt den nächsten Zeiger in der Eingabesequenz vor (geschützte Member-Funktion)
setg	positioniert die Zeiger für Anfang, nächsten und Ende der Eingabesequenz neu (geschützte Member-Funktion)
Put-Bereich
xsputn [virtuell]	schreibt mehrere Zeichen in die Ausgabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
overflow [virtuell]	schreibt Zeichen aus dem Put-Bereich in die zugeordnete Ausgabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)
pbasepptrepptr	gibt einen Zeiger auf den Anfang, das aktuelle Zeichen und das Ende des Put-Bereichs zurück (geschützte Member-Funktion)
pbump	rückt den nächsten Zeiger der Ausgabesequenz vor (geschützte Member-Funktion)
setp	positioniert die Zeiger für Anfang, nächsten und Ende der Ausgabesequenz neu (geschützte Member-Funktion)
Putback
pbackfail [virtuell]	legt ein Zeichen in die Eingabesequenz zurück, möglicherweise unter Änderung der Eingabesequenz (virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>)

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_fstream_native_handle	202306L	(C++26)	Unterstützung nativer Handles

Siehe auch

FILE	Objekttyp, der alle für die Steuerung eines C-I/O-Streams benötigten Informationen speichern kann (typedef)