std::basic_ifstream

 

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_ifstream

Memberfunktionen

basic_ifstream::basic_ifstream

basic_ifstream::operator= (C++11)

basic_ifstream::swap (C++11)

basic_ifstream::rdbuf

basic_ifstream::native_handle (C++26)

Dateioperationen

basic_ifstream::is_open

basic_ifstream::open

basic_ifstream::close

Nicht-Member-Funktionen

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

 

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

Die Klassenschablone basic_ifstream implementiert High-Level-Eingabeoperationen auf dateibasierten Streams. Sie verbindet einen dateibasierten Streambuffer (std::basic_filebuf) mit der High-Level-Schnittstelle von (std::basic_istream).

Eine typische Implementierung von std::basic_ifstream enthält nur ein nicht abgeleitetes Datenmitglied: eine Instanz von std::basic_filebuf<CharT, Traits>.

Vererbungdiagramm

Mehrere Typedefs für gängige Zeichentypen werden bereitgestellt

Definiert in Header <fstream>
Typ	Definition
std::ifstream	std::basic_ifstream<char>
std::wifstream	std::basic_ifstream<wchar_t>

Member-Typen

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
native_handle_type(C++26)	implementierungsabhängiger Typ, der TriviallyCopyable und semiregular ist

Memberfunktionen

(Konstruktor)	konstruiert den Datei-Stream (public member function)
(Destruktor) [virtual] (implizit deklariert)	Destruiert das basic_ifstream und den zugehörigen Puffer, schließt die Datei (virtual public member function)
operator= (C++11)	verschiebt den Datei-Stream (public member function)
swap (C++11)	tauscht zwei Datei-Streams (public member function)
rdbuf	gibt das zugrundeliegende Rohdatei-Geräteobjekt zurück (public member function)
native_handle (C++26)	gibt den zugrundeliegenden implementierungsabhängigen Handle zurück (public member function)
Dateioperationen
is_open	prüft, ob der Stream eine zugeordnete Datei hat (public member function)
open	öffnet eine Datei und ordnet sie dem Stream zu (public member function)
close	schließt die zugeordnete Datei (public member function)

Nicht-Member-Funktionen

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

spezialisiert den Algorithmus std::swap (Funktionsvorlage)

Abgeleitet von std::basic_istream

Memberfunktionen

Formatierte Eingabe
operator>>	extrahiert formatierte Daten (public member function of std::basic_istream<CharT,Traits>)
Unformatierte Eingabe
get	extrahiert Zeichen (public member function of std::basic_istream<CharT,Traits>)
peek	liest das nächste Zeichen ohne es zu extrahieren (public member function of std::basic_istream<CharT,Traits>)
unget	entfernt ein Zeichen aus dem Eingabestrom (public member function of std::basic_istream<CharT,Traits>)
putback	legt ein Zeichen in den Eingabestrom zurück (public member function of std::basic_istream<CharT,Traits>)
getline	extrahiert Zeichen, bis das gegebene Zeichen gefunden wird (public member function of std::basic_istream<CharT,Traits>)
ignorieren	extrahiert und verwirft Zeichen, bis das gegebene Zeichen gefunden wird (public member function of std::basic_istream<CharT,Traits>)
read	extrahiert Zeichenblöcke (public member function of std::basic_istream<CharT,Traits>)
readsome	extrahiert bereits verfügbare Zeichenblöcke (public member function of std::basic_istream<CharT,Traits>)
gcount	gibt die Anzahl der Zeichen zurück, die von der letzten unformatierten Eingabeoperation extrahiert wurden (public member function of std::basic_istream<CharT,Traits>)
Positionierung
tellg	gibt den Eingabepositionsindikator zurück (public member function of std::basic_istream<CharT,Traits>)
seekg	setzt den Eingabepositionsindikator (public member function of std::basic_istream<CharT,Traits>)
Sonstiges
sync	synchronisiert mit dem zugrunde liegenden Speichermedium (public member function of std::basic_istream<CharT,Traits>)

Member-Klassen

sentry

implementiert grundlegende Logik für die Vorbereitung des Streams für Eingabeoperationen (public member class of std::basic_istream<CharT,Traits>)

Geerbt von std::basic_ios

Membertypen

Mitgliedertyp	Definition
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

Memberfunktionen

Zustandsfunktionen
good	prüft, ob kein Fehler aufgetreten ist, d.h. I/O-Operationen verfügbar sind (public member function of std::basic_ios<CharT,Traits>)
eof	prüft, ob das Dateiende erreicht wurde (public member function of std::basic_ios<CharT,Traits>)
fail	prüft, ob ein Fehler aufgetreten ist (public member function of std::basic_ios<CharT,Traits>)
bad	prüft, ob ein nicht behebbbarer Fehler aufgetreten ist (public member function of std::basic_ios<CharT,Traits>)
operator!	prüft, ob ein Fehler aufgetreten ist (Synonym für fail()) (public member function of std::basic_ios<CharT,Traits>)
operator bool	prüft, ob kein Fehler aufgetreten ist (Synonym für !fail()) (public member function of std::basic_ios<CharT,Traits>)
rdstate	gibt Zustandsflags zurück (public member function of std::basic_ios<CharT,Traits>)
setstate	setzt Zustandsflags (public member function of std::basic_ios<CharT,Traits>)
clear	modifiziert Zustandsflags (public member function of std::basic_ios<CharT,Traits>)
Formatierung
copyfmt	kopiert Formatierungsinformationen (public member function of std::basic_ios<CharT,Traits>)
fill	verwaltet das Füllzeichen (public member function of std::basic_ios<CharT,Traits>)
Sonstiges
exceptions	verwaltet die Exception-Maske (public member function of std::basic_ios<CharT,Traits>)
imbue	setzt die Locale (public member function of std::basic_ios<CharT,Traits>)
rdbuf	verwaltet den zugehörigen Stream-Puffer (public member function of std::basic_ios<CharT,Traits>)
tie	verwaltet den gebundenen Stream (public member function of std::basic_ios<CharT,Traits>)
narrow	verengt Zeichen (public member function of std::basic_ios<CharT,Traits>)
widen	erweitert Zeichen (public member function of std::basic_ios<CharT,Traits>)

Geerbt von std::ios_base

Memberfunktionen

Formatierung
flags	verwaltet Formatierungsflags (public member function of std::ios_base)
setf	setzt spezifische Formatierungsflags (public member function of std::ios_base)
unsetf	löscht spezifische Formatierungsflags (public member function of std::ios_base)
precision	verwaltet die Dezimalgenauigkeit von Fließkommaoperationen (public member function of std::ios_base)
width	verwaltet die Feldbreite (public member function of std::ios_base)
Lokale
imbue	setzt Locale (public member function of std::ios_base)
getloc	gibt die aktuelle Locale zurück (public member function of std::ios_base)
Internes erweiterbares Array
xalloc [static]	gibt eine programmweite eindeutige Ganzzahl zurück, die sicher als Index für pword() und iword() verwendet werden kann (public static member function of std::ios_base)
iword	vergrößert den privaten Speicher bei Bedarf und greift auf das long-Element am gegebenen Index zu (public member function of std::ios_base)
pword	vergrößert den privaten Speicher bei Bedarf und greift auf das void*-Element am gegebenen Index zu (public member function of std::ios_base)
Sonstiges
register_callback	registriert eine Callback-Funktion für Ereignisse (public member function of std::ios_base)
sync_with_stdio [static]	legt fest, ob C++ und C E/A-Bibliotheken interoperabel sind (public static member function of std::ios_base)
Member-Klassen
failure	Stream-Exception (public member class of std::ios_base)
Init	initialisiert Standard-Stream-Objekte (public member class of std::ios_base)

Member-Typen und Konstanten
Typ	Erklärung
openmode	Stream-Öffnungsmodus-Typ Folgende Konstanten sind ebenfalls definiert Konstante Erklärung app an das Ende des Streams gehen vor jedem Schreibvorgang binary im Binärmodus öffnen in zum Lesen öffnen out zum Schreiben öffnen trunc den Inhalt des Streams beim Öffnen verwerfen ate sofort nach dem Öffnen zum Ende des Streams gehen noreplace (C++23) im exklusiven Modus öffnen (typedef)
fmtflags	Typ der Formatierungsflags Folgende Konstanten sind ebenfalls definiert Konstante Erklärung dez dezimales Basis für Ganzzahl-E/A verwenden: siehe std::dec okt oktal-Basis für Ganzzahl-E/A verwenden: siehe std::oct hex hexadezimal-Basis für Ganzzahl-E/A verwenden: siehe std::hex basefield dec | oct | hex. Nützlich für Maskierungsoperationen left linksbündige Ausrichtung (fügt Füllzeichen rechts hinzu): siehe std::left right rechtsbündige Ausrichtung (fügt Füllzeichen links hinzu): siehe std::right internal interne Ausrichtung (fügt Füllzeichen an der intern definierten Stelle ein): siehe std::internal adjustfield left | right | internal. Nützlich für Maskierungsoperationen scientific erzeugt Fließkommatypen in wissenschaftlicher Notation oder in Hex-Notation, wenn mit fixed kombiniert: siehe std::scientific fixed erzeugt Fließkommatypen in fester Notation oder in Hex-Notation, wenn mit scientific kombiniert: siehe std::fixed floatfield scientific | fixed. Nützlich für Maskierungsoperationen boolalpha fügt bool-Typen im alphanumerischen Format ein und extrahiert sie: siehe std::boolalpha showbase erzeugt ein Präfix, das die numerische Basis für die Ganzzahl-Ausgabe angibt, erfordert den Währungsindikator bei monetären E/A: siehe std::showbase showpoint erzeugt bedingungslos ein Dezimaltrennzeichen für die Ausgabe von Fließkommazahlen: siehe std::showpoint showpos erzeugt ein + Zeichen für nicht-negative numerische Ausgaben: siehe std::showpos skipws überspringt führende Leerzeichen vor bestimmten Eingabeoperationen: siehe std::skipws unitbuf leert den Ausgabepuffer nach jeder Ausgabeoperation: siehe std::unitbuf uppercase ersetzt bestimmte Kleinbuchstaben durch ihre Großbuchstaben-Äquivalente bei bestimmten Ausgabeoperationen: siehe std::uppercase (typedef)
iostate	Zustand des Stream-Typs Folgende Konstanten sind ebenfalls definiert Konstante Erklärung goodbit kein Fehler badbit irreparabler Stream-Fehler failbit Eingabe-/Ausgabeoperation fehlgeschlagen (Formatierungs- oder Extraktionsfehler) eofbit zugeordnete Eingabesequenz hat das Dateiende erreicht (typedef)
seekdir	Typ der Suchrichtung Folgende Konstanten sind ebenfalls definiert Konstante Erklärung beg der Anfang eines Streams end das Ende eines Streams cur die aktuelle Position des Stream-Positionsindikators (typedef)
event	spezifiziert den Ereignistyp (enum)
event_callback	Callback-Funktionstyp (typedef)

Hinweise

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

Beispiel

Führen Sie diesen Code aus

#include <fstream>
#include <iostream>
#include <string>
 
int main()
{
    std::string filename = "Test.b";
 
    // prepare a file to read
    double d = 3.14;
    std::ofstream(filename, std::ios::binary)
        .write(reinterpret_cast<char*>(&d), sizeof d) << 123 << "abc";
 
    // open file for reading
    std::ifstream istrm(filename, std::ios::binary);
    if (!istrm.is_open())
        std::cout << "failed to open " << filename << '\n';
    else
    {
        double d;
        istrm.read(reinterpret_cast<char*>(&d), sizeof d); // binary input
        int n;
        std::string s;
        if (istrm >> n >> s)                               // text input
            std::cout << "read back from file: " << d << ' ' << n << ' ' << s << '\n';
    }
}

Ausgabe

read back from file: 3.14 123 abc