std::basic_streambuf<CharT,Traits>:underflow

 

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 underflow();

Stellt sicher, dass mindestens ein Zeichen im Eingabebereich verfügbar ist, indem die Zeiger auf den Eingabebereich (falls erforderlich) aktualisiert und weitere Daten aus der Eingabesequenz gelesen werden (falls zutreffend). Gibt den Wert dieses Zeichens (konvertiert in int_type mit Traits::to_int_type(c)) bei Erfolg oder Traits::eof() bei Fehler zurück.

Die Funktion kann die Zeiger gptr, egptr und eback aktualisieren, um die Position neu geladener Daten (falls vorhanden) zu definieren. Bei einem Fehler stellt die Funktion sicher, dass entweder gptr() == nullptr oder gptr() == egptr.

Die Basisklassenversion der Funktion tut nichts. Die abgeleiteten Klassen können diese Funktion überschreiben, um Aktualisierungen des Get-Bereichs im Falle der Erschöpfung zu ermöglichen.

Parameter

(keine)

Rückgabewert

Der Wert des Zeichens, auf das nach dem Aufruf vom *Get-Zeiger* gezeigt wird, bei Erfolg oder Traits::eof() andernfalls.

Die Basisklassenversion der Funktion gibt traits::eof() zurück.

Hinweis

Die öffentlichen Funktionen von std::streambuf rufen diese Funktion nur auf, wenn gptr() == nullptr oder gptr() >= egptr().

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <sstream>
 
class null_filter_buf : public std::streambuf
{
    std::streambuf* src;
    char ch; // single-byte buffer
protected:
    int underflow()
    {
        traits_type::int_type i;
        while ((i = src->sbumpc()) == '\0')
            ; // skip zeroes
        if (!traits_type::eq_int_type(i, traits_type::eof()))
        {
            ch = traits_type::to_char_type(i);
            setg(&ch, &ch, &ch+1); // make one read position available
        }
        return i;
    }
public:
    null_filter_buf(std::streambuf* buf) : src(buf)
    {
        setg(&ch, &ch + 1, &ch + 1); // buffer is initially full
    }
};
 
void filtered_read(std::istream& in)
{
    std::streambuf* orig = in.rdbuf();
    null_filter_buf buf(orig);
    in.rdbuf(&buf);
    for (char c; in.get(c);)
        std::cout << c;
    in.rdbuf(orig);
}
 
int main()
{
    char a[] = "This i\0s \0an e\0\0\0xample";
    std::istringstream in(std::string(std::begin(a), std::end(a)));
    filtered_read(in);
}

Ausgabe

This is an example

Siehe auch

uflow [virtuell]	liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich und rückt den nächsten Zeiger vor (virtuelle geschützte Memberfunktion)
overflow [virtuell]	schreibt Zeichen aus dem Put-Bereich in die zugeordnete Ausgabesequenz (virtuelle geschützte Memberfunktion)
underflow [virtuell]	liest aus der zugeordneten Datei (virtuelle protected Memberfunktion von std::basic_filebuf<CharT,Traits>)
underflow [virtuell]	gibt das nächste in der Eingabesequenz verfügbare Zeichen zurück (virtuelle protected Memberfunktion von std::basic_stringbuf<CharT,Traits,Allocator>)
underflow [virtuell]	liest ein Zeichen aus der Eingabesequenz, ohne den Zeiger auf das nächste Zeichen vorzuschieben (virtuelle protected Memberfunktion von std::strstreambuf)