std::basic_streambuf<CharT,Traits>::pbackfail

 

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_streambuf

Öffentliche Memberfunktionen basic_streambuf::~basic_streambuf      Lokale basic_streambuf::pubimbue basic_streambuf::getloc Positionierung basic_streambuf::pubsetbuf basic_streambuf::pubseekoff basic_streambuf::pubseekpos basic_streambuf::pubsync Get-Bereich basic_streambuf::in_avail basic_streambuf::snextc basic_streambuf::sbumpc basic_streambuf::sgetc basic_streambuf::sgetn Put-Bereich basic_streambuf::sputc basic_streambuf::sputn Putback basic_streambuf::sputbackc basic_streambuf::sungetc

Geschützte Memberfunktionen basic_streambuf::basic_streambuf basic_streambuf::operator= (C++11) basic_streambuf::swap (C++11) Lokale basic_streambuf::imbue Positionierung basic_streambuf::setbuf basic_streambuf::seekoff basic_streambuf::seekpos basic_streambuf::sync Get-Bereich basic_streambuf::showmanyc basic_streambuf::underflow basic_streambuf::uflow basic_streambuf::xsgetn basic_streambuf::ebackbasic_streambuf::gptrbasic_streambuf::egptr basic_streambuf::gbump basic_streambuf::setg Put-Bereich basic_streambuf::xsputn basic_streambuf::overflow basic_streambuf::pbasebasic_streambuf::pptrbasic_streambuf::epptr basic_streambuf::pbump basic_streambuf::setp Putback basic_streambuf::pbackfail

 

protected: virtual int_type pbackfail( int_type c = Traits::eof() );

Diese Funktion kann nur aufgerufen werden, wenn eine der folgenden Bedingungen erfüllt ist:

• gptr() ist Null,
• gptr() = eback(), oder
• traits::eq(traits::to_char_type(c), gptr()[-1]) gibt false zurück.

Diese Funktion wird von den öffentlichen Funktionen sungetc() und sputbackc() (die wiederum von basic_istream::unget und basic_istream::putback aufgerufen werden) aufgerufen, wenn entweder

1) Es gibt keine Rückstellposition im Lesegebiet (pbackfail() wird ohne Argumente aufgerufen). In dieser Situation ist der Zweck von pbackfail(), das Lesegebiet um ein Zeichen zurückzusetzen, falls die zugeordnete Zeichensequenz dies zulässt (z. B. kann ein dateibezogener Streambuf den Puffer aus einer Datei neu laden, beginnend mit einem Zeichen früher).

2) Der Aufrufer versucht, ein anderes Zeichen zurückzustellen als das zuvor abgerufene (pbackfail() wird mit dem zurückzustellenden Zeichen aufgerufen). In dieser Situation besteht der Zweck von pbackfail() darin, das Zeichen c in das Lesegebiet an die Position unmittelbar vor basic_streambuf::gptr() zu legen und, falls möglich, die zugeordnete Zeichensequenz zu ändern, um diese Änderung widerzuspiegeln. Dies kann das Zurücksetzen des Lesegebiets wie in der ersten Variante beinhalten.

Die Standard-Basisklassenversion dieser Funktion tut nichts und gibt in allen Situationen Traits::eof() zurück. Diese Funktion wird von den abgeleiteten Klassen überschrieben: basic_stringbuf::pbackfail, basic_filebuf::pbackfail, strstreambuf::pbackfail und soll von benutzerdefinierten und Drittanbieter-Streamklassen überschrieben werden.

Parameter

ch

-

Zurückzustellenndes Zeichen oder Traits::eof(), wenn nur ein Zurücksetzen angefordert wird

Rückgabewert

Traits::eof() im Fehlerfall, ein anderer Wert, um Erfolg anzuzeigen. Die Basisklassenversion schlägt immer fehl.

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 32	C++98	Die Aufrufbedingung 'traits::eq(*gptr(),traits::to_char_type(c)) gibt false zurück' passte nicht zur Beschreibung von sputbackc()	korrigiert, um zu passen die Beschreibung

Siehe auch

pbackfail [virtuell]	Setzt die Eingabesequenz zurück, um ein Zeichen zurückzugeben, ohne die zugehörige Datei zu beeinflussen (virtuelle geschützte Memberfunktion von std::basic_filebuf<CharT,Traits>)
pbackfail [virtuell]	Gibt ein Zeichen in die Eingabesequenz zurück (virtuelle geschützte Memberfunktion von std::basic_stringbuf<CharT,Traits,Allocator>)
pbackfail [virtuell]	Setzt die Eingabesequenz zurück, um ein Zeichen zurückzugeben (virtuelle geschützte Memberfunktion von std::strstreambuf)
sungetc	verschiebt den nächsten Zeiger in der Eingabesequenz um eins zurück (öffentliche Memberfunktion)
sputbackc	legt ein Zeichen zurück in die Eingabesequenz (öffentliche Memberfunktion)