std::basic_filebuf<CharT,Traits>:: underflow

Liest weitere Daten in den Eingabebereich.

Verhält sich wie die Basisklasse std :: basic_streambuf :: underflow , mit der Ausnahme, dass zum Lesen der Daten aus der zugeordneten Zeichensequenz (der Datei) in den Lesebereich zunächst die Bytes aus der Datei in einen temporären Puffer (der bei Bedarf entsprechend groß alloziert wird) gelesen werden, dann std :: codecvt :: in des eingestellten Locale verwendet wird, um die externe (typischerweise Multibyte-) Darstellung in die interne Form zu konvertieren, die dann zur Befüllung des Lesebereichs dient. Die Konvertierung kann übersprungen werden, wenn std :: codecvt :: always_noconv des Locale true zurückgibt.

Parameter

(keine)

Rückgabewert

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

Beispiel

#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()) ;
}

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