Namensräume
Varianten
Aktionen

std::basic_stringbuf<CharT,Traits,Allocator>::underflow

Von cppreference.com
< cpp‎ | io‎ | basic stringbuf
 
C++
 
Ein-/Ausgabe-Bibliothek
 
std::basic_stringbuf
 
protected:
virtual int_type underflow()

Liest das nächste Zeichen aus dem Lese-Bereich des Puffers.

Genauer gesagt:

1) Wenn die Eingabesequenz eine Lese-Position zur Verfügung hat (egptr() > gptr()), gibt Traits::to_int_type(*gptr()) zurück.
2) Andernfalls, wenn pptr() > egptr() (seit dem letzten Aufruf von overflow(), der egptr() verändert hat, wurden einige Zeichen in den Stream eingefügt), dann wird der Lese-Bereich erweitert, um die zuletzt eingefügten Zeichen einzuschließen, indem egptr() auf den Wert von pptr() gesetzt wird. Anschließend wird Traits::to_int_type(*gptr()) zurückgegeben.
3) Andernfalls gibt Traits::eof() zurück.

Jedes Zeichen im Puffer, das initialisiert wurde, unabhängig davon, ob es aus dem im Konstruktor übergebenen String stammt oder durch overflow() angehängt wurde, wird als Teil der Eingabesequenz betrachtet.

Inhalt

[edit] Parameter

(keine)

[edit] Rückgabewert

Traits::to_int_type(*gptr()) (das nächste zu lesende Zeichen im Lese-Bereich) im Erfolgsfall, oder Traits::eof() im Fehlerfall.

[edit] Beispiel

Führen Sie diesen Code aus
#include <iostream>
#include <sstream>
 
struct mybuf : std::stringbuf
{
    mybuf(const std::string& new_str,
          std::ios_base::openmode which = std::ios_base::in | std::ios_base::out)
        : std::stringbuf(new_str, which) {}
 
    int_type overflow(int_type c)
    {
        std::cout << "Before overflow():  get area size is " << egptr() - eback()
                  << ", the put area size is " << epptr() - pbase() << '\n';
        int_type rc = std::stringbuf::overflow(c);
        std::cout << "After overflow():   get area size is " << egptr() - eback()
                  << ", put area size is " << epptr() - pbase() << '\n';
        return rc;
    }
 
    int_type underflow()
    {
        std::cout << "Before underflow(): get area size is " << egptr() - eback()
                  << ", put area size is " << epptr() - pbase() << '\n';
        int_type ch = std::stringbuf::underflow();
        std::cout << "After underflow():  get area size is " << egptr() - eback()
                  << ", put area size is " << epptr() - pbase() << '\n';
 
        if (ch == EOF)
            std::cout << "underflow() returns EOF\n";
        else
            std::cout << "underflow() returns '" << char(ch) << "'\n";
        return ch;
    }
};
 
int main()
{
    mybuf sbuf("123"); // read-write stream
    std::iostream stream(&sbuf);
    int n;
    stream >> n; // calls sgetc() four times
                 // three calls return the characters '1', '2', '3'
                 // the fourth call, gptr() == egptr() and underflow() is called
                 // underflow returns EOF
    std::cout << "n = " << n << '\n';
    stream.clear(); // clear the eofbit
 
    stream << "123456"; // sputc() is called 6 times
                        // first three calls store "123" in the existing buffer
                        // 4th call finds that pptr() == epptr() and calls overflow()
                        // overflow() grows the buffer and sets egptr() to 4
                        // 5th and 6th calls store '5' and '6', advancing pptr()
 
    stream >> n; // calls sgetc() 4 times
                 // 1st call returns the '4' that was made available by overflow()
                 // on the 2nd call, egptr() == egptr() and underflow() is called
                 // underflow advances egptr() to equal pptr() (which is 6)
                 // 3rd sgetc() returns '6'
                 // 4th sgetc() finds gptr() == egptr(), calls underflow()
                 // underflow() returns EOF
 
    std::cout << "n = " << n << '\n';
}

Mögliche Ausgabe

Before underflow(): get area size is 3, put area size is 15
After underflow():  get area size is 3, put area size is 15
underflow() returns EOF
n = 123
Before underflow(): get area size is 3, put area size is 15
After underflow():  get area size is 6, put area size is 15
underflow() returns '4'
Before underflow(): get area size is 6, put area size is 15
After underflow():  get area size is 6, put area size is 15
underflow() returns EOF
n = 456

[edit] 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 432 C++98 war unklar, ob Zeichen, die durch overflow() angehängt wurden,
als Teil der Eingabesequenz betrachtet werden.		 wurde klargestellt

[edit] Siehe auch

[virtuell]
 liest Zeichen aus der zugeordneten Eingabesequenz in den Get-Bereich
(virtuelle geschützte Member-Funktion von std::basic_streambuf<CharT,Traits>) [bearbeiten]
[virtuell]
 liest aus der zugeordneten Datei
(virtuelle protected Memberfunktion von std::basic_filebuf<CharT,Traits>) [bearbeiten]
[virtuell]
 liest ein Zeichen aus der Eingabesequenz, ohne den Zeiger auf das nächste Zeichen vorzuschieben
(virtuelle protected Memberfunktion von std::strstreambuf) [bearbeiten]
 liest ein Zeichen aus der Eingabesequenz, ohne die Sequenz vorzurücken
(öffentliche Member-Funktion von std::basic_streambuf<CharT,Traits>) [bearbeiten]
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/io/basic_stringbuf/underflow&oldid=148336"