std::basic_filebuf<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_filebuf

Öffentliche Memberfunktionen

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

Geschützte Memberfunktionen

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

Nicht-Member-Funktionen

swap(std::basic_filebuf) (C++11)

 

protected: virtual int_type underflow()

Liest weitere Daten in den Eingabebereich ein.

Verhält sich wie die Basisklasse std::basic_streambuf::underflow, mit der Ausnahme, dass zum Lesen der Daten aus der zugehörigen Zeichensequenz (der Datei) in den Lese-Bereich zuerst die Bytes aus der Datei in einen temporären Puffer gelesen werden (der so groß wie nötig zugewiesen wird), und dann std::codecvt::in der implantierten Locale verwendet wird, um die externe (typischerweise Multibyte-)Darstellung in die interne Form zu konvertieren, die dann zur Befüllung des Lese-Bereichs verwendet wird. Die Konvertierung kann übersprungen werden, wenn std::codecvt::always_noconv der Locale true zurückgibt.

Parameter

(keine)

Rückgabewert

Traits::to_int_type(*gptr()) (das erste Zeichen der wartenden Sequenz) im Erfolgsfall oder Traits::eof() im Fehlerfall.

Beispiel

Führen Sie diesen Code aus

#include <fstream>
#include <iostream>
 
struct mybuf : std::filebuf
{
    int underflow()
    {
         std::cout << "Before underflow(): size of the get area is "
                   << egptr()-eback() << " with "
                   << egptr()-gptr() << " read positions available\n";
         int rc = std::filebuf::underflow();
         std::cout << "underflow() returns " << rc << ".\nAfter the call, "
                   << "size of the get area is "
                   << egptr()-eback() << " with "
                   << egptr()-gptr() << " read positions available\n";
        return rc;
    }
};
 
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    while (stream.get()) ;
}

Mögliche Ausgabe

Before underflow(): size of the get area is 0 with 0 read positions available
underflow() returns 73.
After the call, size of the get area is 110 with 110 read positions available
Before underflow(): size of the get area is 110 with 0 read positions available
underflow() returns -1.
After the call, size of the get area is 0 with 0 read positions available

Siehe auch

underflow [virtuell]	liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich (virtuelle geschützte Member-Funktion von std::basic_streambuf<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)
uflow [virtuell]	liest aus der zugehörigen Datei und rückt den nächsten Zeiger im Lese-Bereich vor (virtuelle protected Memberfunktion)
overflow [virtuell]	schreibt Zeichen aus dem Schreibbereich in die zugeordnete Datei (virtual protected member function)
sgetc	liest ein Zeichen aus der Eingabesequenz, ohne die Sequenz vorzurücken (öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>)