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

Gibt die Anzahl der Zeichen zurück, die durch den letzten unformatted input operation extrahiert wurden, oder den maximal darstellbaren Wert von std::streamsize falls die Zahl nicht darstellbar ist.

Die folgenden Memberfunktionen von basic_istream ändern den Wert nachfolgender gcount() Aufrufe:

• Move-Konstruktor
• swap()
• get()
• getline()
• ignore()
• read()
• readsome()
• operator>>(basic_streambuf*)

Die folgenden Funktionen setzen gcount() auf null:

• Konstruktor
• putback()
• unget()
• peek()

Parameter

(keine)

Rückgabewert

Die Anzahl der Zeichen, die durch den letzten unformatierten Eingabevorgang extrahiert wurden, oder der maximal darstellbare Wert von std::streamsize falls die Zahl nicht darstellbar ist.

Beispiel

#include <iostream>
#include <sstream>
int main()
{
    char x[20];
    std::istringstream stream("Hello World");
    stream.read(x, sizeof x);
    std::cout << "Characters extracted: " << stream.gcount();
}

Characters extracted: 11

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.