std::basic_istream<CharT,Traits>::unget

 

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_istream

Globale Objekte

cinwcin

Memberfunktionen

basic_istream::basic_istream

basic_istream::~basic_istream

basic_istream::operator= (C++11)

Formatierte Eingabe

basic_istream::operator>>

Unformatierte Eingabe

basic_istream::get

basic_istream::peek

basic_istream::unget

basic_istream::putback

basic_istream::getline

basic_istream::ignore

basic_istream::read

basic_istream::readsome

basic_istream::gcount

Positionierung

basic_istream::tellg

basic_istream::seekg

Sonstiges

basic_istream::sync

basic_istream::swap (C++11)

Member-Klassen

basic_istream::sentry

Nicht-Member-Funktionen

operator>>(std::basic_istream)

 

basic_istream& unget();

Macht das zuletzt extrahierte Zeichen wieder verfügbar.

Zuerst wird eofbit gelöscht. Dann verhält sich(seit C++11) unget als UnformattedInputFunction. Nach dem Konstruieren und Überprüfen des Sentry-Objekts wird, wenn irgendein ios_base::iostate Flag gesetzt ist, failbit gesetzt und die Funktion gibt zurück. Andernfalls wird rdbuf()->sungetc() aufgerufen.

Wenn rdbuf()->sungetc() Traits::eof() zurückgibt, wird setstate(badbit) aufgerufen.

In jedem Fall wird der Zähler gcount() auf Null gesetzt.

Parameter

(keine)

Rückgabewert

*this

Ausnahmen

failure, wenn ein Fehler aufgetreten ist (der Fehlerstatus-Flag ist nicht goodbit) und exceptions() für diesen Zustand zum Werfen gesetzt ist.

Wenn eine interne Operation eine Ausnahme auslöst, wird diese abgefangen und badbit gesetzt. Wenn exceptions() für badbit gesetzt ist, wird die Ausnahme erneut ausgelöst.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
 
int main()
{
    std::istringstream s1("Hello, world.");
    char c1 = s1.get();
    if (s1.unget())
    {
        char c2 = s1.get();
        std::cout << "Got: '" << c1 << "'. Got again: '" << c2 << "'.\n";
    }
}

Ausgabe

Got: 'H'. Got again: 'H'.

Siehe auch

sungetc	verschiebt den nächsten Zeiger in der Eingabesequenz um eins zurück (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)
get	extrahiert Zeichen (public member function)
peek	liest das nächste Zeichen ohne es zu extrahieren (public member function)
putback	legt ein Zeichen in den Eingabestrom zurück (public member function)