std:: basic_istream
|
Definiert im Header
<istream>
|
||
|
template
<
class
CharT,
|
||
Die Klassenvorlage
basic_istream
bietet Unterstützung für hochwertige Eingabeoperationen auf Zeichenströmen. Die unterstützten Operationen umfassen formatierte Eingabe (z.B. Ganzzahlwerte oder durch Leerzeichen getrennte Zeichen und Zeichenketten) und unformatierte Eingabe (z.B. Rohzeichen und Zeichenarrays). Diese Funktionalität wird durch die Schnittstelle implementiert, die von der zugrundeliegenden
basic_streambuf
-Klasse bereitgestellt wird, auf die über die
basic_ios
-Basisklasse zugegriffen wird. Das einzige nicht geerbte Datenelement von
basic_istream
ist in den meisten Implementierungen der von
basic_istream::gcount()
zurückgegebene Wert.
Vererbungsdiagramm
Es werden mehrere Typdefinitionen für gängige Zeichentypen bereitgestellt:
|
Definiert in Header
<istream>
|
|
| Typ | Definition |
std::istream
|
std :: basic_istream < char > |
std::wistream
|
std :: basic_istream < wchar_t > |
Inhaltsverzeichnis |
Globale Objekte
Zwei globale basic_istream-Objekte werden von der Standardbibliothek bereitgestellt.
|
Definiert im Header
<iostream>
|
|
|
liest vom standard C-Eingabestrom
stdin
(globales Objekt) |
|
Mitgliedertypen
| 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
|
Konstruiert das Objekt
(öffentliche Elementfunktion) |
|
|
[virtual]
|
zerstört das Objekt
(virtuelle öffentliche Elementfunktion) |
|
(C++11)
|
bewegt Zuweisung von einem anderen
basic_istream
(geschützte Elementfunktion) |
Formatierte Eingabe |
|
|
extrahiert formatierte Daten
(öffentliche Elementfunktion) |
|
Unformatierte Eingabe |
|
|
extrahiert Zeichen
(öffentliche Elementfunktion) |
|
|
liest das nächste Zeichen ohne es zu extrahieren
(öffentliche Elementfunktion) |
|
|
hebt die Extraktion eines Zeichens auf
(öffentliche Elementfunktion) |
|
|
gibt ein Zeichen in den Eingabestrom zurück
(öffentliche Elementfunktion) |
|
|
extrahiert Zeichen bis zum gefundenen angegebenen Zeichen
(öffentliche Elementfunktion) |
|
|
extrahiert und verwirft Zeichen bis zum gefundenen angegebenen Zeichen
(öffentliche Elementfunktion) |
|
|
extrahiert Zeichenblöcke
(öffentliche Elementfunktion) |
|
|
extrahiert bereits verfügbare Zeichenblöcke
(öffentliche Elementfunktion) |
|
|
gibt die Anzahl der durch die letzte unformatierte Eingabeoperation extrahierten Zeichen zurück
(öffentliche Elementfunktion) |
|
Positionierung |
|
|
gibt die Eingabepositionsanzeige zurück
(öffentliche Elementfunktion) |
|
|
setzt die Eingabepositionsanzeige
(öffentliche Elementfunktion) |
|
Sonstiges |
|
|
synchronisiert mit dem zugrundeliegenden Speichergerät
(öffentliche Elementfunktion) |
|
|
(C++11)
|
tauscht Stromobjekte, außer dem zugehörigen Puffer
(geschützte Elementfunktion) |
Mitgliedsklassen
|
implementiert grundlegende Logik zur Vorbereitung des Streams für Eingabeoperationen
(öffentliche Mitgliedsklasse) |
Nicht-Member-Funktionen
|
extrahiert Zeichen und Zeichenarrays
(Funktions-Template) |
Geerbt von std:: basic_ios
Member-Typen
| Member-Typ | Definition |
char_type
|
CharT
|
traits_type
|
Traits
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
Member-Funktionen
Status-Funktionen |
|
|
prüft, ob kein Fehler aufgetreten ist, d.h. I/O-Operationen verfügbar sind
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
prüft, ob das Dateiende erreicht wurde
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
prüft, ob ein Fehler aufgetreten ist
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
prüft, ob ein nicht behebbarer Fehler aufgetreten ist
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
prüft, ob ein Fehler aufgetreten ist (Synonym für
fail()
)
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
prüft, ob kein Fehler aufgetreten ist (Synonym für
!
fail()
)
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
gibt Statusflags zurück
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
setzt Statusflags
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
modifiziert Statusflags
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
Formatierung |
|
|
kopiert Formatierungsinformationen
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
verwaltet das Füllzeichen
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
Sonstiges |
|
|
verwaltet die Ausnahmemaske
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
setzt das Locale
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
verwaltet den assoziierten Streampuffer
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
verwaltet den verknüpften Stream
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
verengt Zeichen
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
|
erweitert Zeichen
(öffentliche Member-Funktion von
std::basic_ios<CharT,Traits>
)
|
|
Geerbt von std:: ios_base
Memberfunktionen
Formatierung |
|
|
verwaltet Formatierungsflags
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
setzt spezifische Formatierungsflags
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
löscht spezifische Formatierungsflags
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
verwaltet Dezimalgenauigkeit von Gleitkommaoperationen
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
verwaltet Feldbreite
(öffentliche Elementfunktion von
std::ios_base
)
|
|
Locales |
|
|
setzt Locale
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
gibt aktuelle Locale zurück
(öffentliche Elementfunktion von
std::ios_base
)
|
|
Internes erweiterbares Array |
|
|
[static]
|
gibt eine programmweit eindeutige Ganzzahl zurück, die sicher als Index für
pword()
und
iword()
verwendet werden kann
(öffentliche statische Elementfunktion von
std::ios_base
)
|
|
vergrößert bei Bedarf den privaten Speicher und ermöglicht Zugriff auf das
long
Element am gegebenen Index
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
vergrößert bei Bedarf den privaten Speicher und ermöglicht Zugriff auf das
void
*
Element am gegebenen Index
(öffentliche Elementfunktion von
std::ios_base
)
|
|
Verschiedenes |
|
|
registriert Ereignis-Callback-Funktion
(öffentliche Elementfunktion von
std::ios_base
)
|
|
|
[static]
|
legt fest, ob C++ und C I/O-Bibliotheken interoperabel sind
(öffentliche statische Elementfunktion von
std::ios_base
)
|
Elementklassen |
|
|
Stream-Exception
(öffentliche Elementklasse von
std::ios_base
)
|
|
|
initialisiert Standard-Stream-Objekte
(öffentliche Elementklasse von
std::ios_base
)
|
|
Mitgliedstypen und Konstanten |
|||||||||||||||||||||||||||||||||||||||
| Typ | Erklärung | ||||||||||||||||||||||||||||||||||||||
|
Stream-Öffnungsmodus-Typ
Folgende Konstanten sind ebenfalls definiert:
(Typedef) |
|||||||||||||||||||||||||||||||||||||||
|
Formatierungsflags-Typ
Die folgenden Konstanten sind ebenfalls definiert:
(Typdefinition) |
|||||||||||||||||||||||||||||||||||||||
|
Zustandstyp des Streams
Folgende Konstanten sind ebenfalls definiert:
(Typdefinition) |
|||||||||||||||||||||||||||||||||||||||
|
Suchrichtungstyp
Folgende Konstanten sind ebenfalls definiert:
(Typdefinition) |
|||||||||||||||||||||||||||||||||||||||
|
gibt den Ereignistyp an
(enum) |
|||||||||||||||||||||||||||||||||||||||
|
Callback-Funktionstyp
(typedef) |
|||||||||||||||||||||||||||||||||||||||