Namespaces
Variants

std:: basic_spanstream

From cppreference.net
< cpp ‎ | io
Definiert im Header <spanstream>
template <

class CharT,
class Traits = std:: char_traits < CharT >
> class basic_spanstream

: public basic_iostream < CharT, Traits >
(seit C++23)

Die Klassenvorlage std::basic_spanstream implementiert Eingabe- und Ausgabeoperationen auf Streams basierend auf festen Puffern.

Auf niedriger Ebene umhüllt die Klasse im Wesentlichen eine Roh-Device-Implementierung von std::basic_spanbuf in eine höhere Schnittstelle von std::basic_iostream . Die vollständige Schnittstelle zu den einzigartigen std::basic_spanbuf -Membern wird bereitgestellt.

cpp/io/ios base cpp/io/basic ios cpp/io/basic istream cpp/io/basic ostream cpp/io/basic iostream std-basic spanstream-inheritance.svg

Vererbungsdiagramm

Es werden mehrere Typdefinitionen für gängige Zeichentypen bereitgestellt:

Definiert im Header <spanstream>
Typ Definition
std::spanstream std :: basic_spanstream < char >
std::wspanstream std :: basic_spanstream < wchar_t >

Inhaltsverzeichnis

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

Datenmitglieder

Mitgliedername Definition
sb (privat) Der gekapselte std::basic_spanbuf .
( Nur zur Darstellung verwendetes Mitgliedsobjekt* )

Memberfunktionen

konstruiert den basic_spanstream
(öffentliche Elementfunktion)
(Destruktor)
[virtual]
zerstört den basic_spanstream
(virtuelle öffentliche Elementfunktion)
bewegt Zuweisung für den basic_spanstream
(öffentliche Elementfunktion)
tauscht zwei basic_spanstream Objekte
(öffentliche Elementfunktion)
erhält die Adresse des umschlossenen rohen span Geräteobjekts
(öffentliche Elementfunktion)
Operationen auf dem zugrundeliegenden Puffer
erhält oder setzt den zugrundeliegenden Puffer des umschlossenen span Geräteobjekts
(öffentliche Elementfunktion)

Nicht-Member-Funktionen

spezialisiert den std::swap Algorithmus
(Funktionsschablone)

Geerbt von std:: basic_istream

Elementfunktionen

Formatierte Eingabe
extrahiert formatierte Daten
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
Unformatierte Eingabe
extrahiert Zeichen
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
liest das nächste Zeichen ohne es zu extrahieren
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
gibt ein Zeichen zurück
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
legt ein Zeichen in den Eingabestrom zurück
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
extrahiert Zeichen bis zum angegebenen Zeichen
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
extrahiert und verwirft Zeichen bis zum angegebenen Zeichen
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
extrahiert Zeichenblöcke
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
extrahiert bereits verfügbare Zeichenblöcke
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
gibt die Anzahl der zuletzt extrahierten Zeichen zurück
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
Positionierung
gibt die Eingabepositionsanzeige zurück
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
setzt die Eingabepositionsanzeige
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )
Sonstiges
synchronisiert mit dem zugrundeliegenden Speichergerät
(öffentliche Elementfunktion von std::basic_istream<CharT,Traits> )

Elementklassen

implementiert grundlegende Logik zur Vorbereitung des Streams für Eingabeoperationen
(öffentliche Elementklasse von std::basic_istream<CharT,Traits> )

Geerbt von std:: basic_ostream

Elementfunktionen

Formatierte Ausgabe
fügt formatierte Daten ein
(öffentliche Elementfunktion von std::basic_ostream<CharT,Traits> )
Unformatierte Ausgabe
fügt ein Zeichen ein
(öffentliche Elementfunktion von std::basic_ostream<CharT,Traits> )
fügt Zeichenblöcke ein
(öffentliche Elementfunktion von std::basic_ostream<CharT,Traits> )
Positionierung
gibt die Ausgabepositionsanzeige zurück
(öffentliche Elementfunktion von std::basic_ostream<CharT,Traits> )
setzt die Ausgabepositionsanzeige
(öffentliche Elementfunktion von std::basic_ostream<CharT,Traits> )
Verschiedenes
synchronisiert mit dem zugrundeliegenden Speichergerät
(öffentliche Elementfunktion von std::basic_ostream<CharT,Traits> )

Elementklassen

implementiert grundlegende Logik zur Vorbereitung des Streams für Ausgabeoperationen
(öffentliche Elementklasse von std::basic_ostream<CharT,Traits> )

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> )
Verschiedenes
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 )
Sonstiges
registriert Ereignis-Callback-Funktion
(öffentliche Elementfunktion von std::ios_base )
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:

Konstante Erklärung
app Vor jedem Schreibvorgang zum Ende des Streams positionieren
binary Im Binärmodus öffnen
in Zum Lesen öffnen
out Zum Schreiben öffnen
trunc Stream-Inhalt beim Öffnen verwerfen
ate Unmittelbar nach dem Öffnen zum Ende des Streams positionieren
noreplace (C++23) Im exklusiven Modus öffnen

(Typedef)
Formatierungsflags-Typ

Die folgenden Konstanten sind ebenfalls definiert:

Konstante Erklärung
dec Dezimalbasis für Integer-Ein-/Ausgabe verwenden: siehe std::dec
oct Oktalbasis für Integer-Ein-/Ausgabe verwenden: siehe std::oct
hex Hexadezimalbasis für Integer-Ein-/Ausgabe 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 internem Designationspunkt hinzu): siehe std::internal
adjustfield left | right | internal . Nützlich für Maskierungsoperationen
scientific Gleitkommatypen in wissenschaftlicher Notation oder Hexadezimalnotation (wenn mit fixed kombiniert) generieren: siehe std::scientific
fixed Gleitkommatypen in Festkommanotation oder Hexadezimalnotation (wenn mit scientific kombiniert) generieren: siehe std::fixed
floatfield scientific | fixed . Nützlich für Maskierungsoperationen
boolalpha bool -Typ im alphanumerischen Format einfügen und extrahieren: siehe std::boolalpha
showbase Präfix für numerische Basis bei Integer-Ausgabe generieren, Währungsindikator bei monetärer Ein-/Ausgabe erfordern: siehe std::showbase
showpoint Dezimalpunktzeichen bedingungslos für Gleitkommazahlen-Ausgabe generieren: siehe std::showpoint
showpos + -Zeichen für nicht-negative numerische Ausgabe generieren: siehe std::showpos
skipws Führende Leerzeichen vor bestimmten Eingabeoperationen überspringen: siehe std::skipws
unitbuf Ausgabe nach jeder Ausgabeoperation leeren: siehe std::unitbuf
uppercase Bestimmte Kleinbuchstaben durch entsprechende Großbuchstaben in bestimmten Ausgabeoperationen ersetzen: siehe std::uppercase

(Typedef)
Zustandstyp des Streams

Folgende Konstanten sind ebenfalls definiert:

Konstante Erklärung
goodbit kein Fehler
badbit nicht behebbarer Stream-Fehler
failbit Ein-/Ausgabeoperation fehlgeschlagen (Formatierungs- oder Extraktionsfehler)
eofbit zugehörige Eingabesequenz hat Dateiende erreicht

(Typdefinition)
Suchrichtungstyp

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

(Typdefinition)
gibt den Ereignistyp an
(enum)
Callback-Funktionstyp
(typedef)

Hinweise

Feature-Test Makro Wert Std Feature
__cpp_lib_spanstream 202106L (C++23) std::spanbuf , std::spanstream