Namensräume
Varianten
Aktionen

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

Von cppreference.com
< cpp‎ | io‎ | basic istream
 
 
 
 
std::streamsize gcount() const;

Gibt die Anzahl der Zeichen zurück, die durch die letzte unformatierte Eingabeoperation extrahiert wurden, oder den maximal darstellbaren Wert von std::streamsize, wenn die Anzahl nicht darstellbar ist.

Die folgenden Member-Funktionen von basic_istream ändern den Wert nachfolgender gcount()-Aufrufe:

Die folgenden Funktionen setzen gcount() auf Null:

Inhalt

[bearbeiten] Parameter

(keine)

[bearbeiten] Rückgabewert

Die Anzahl der Zeichen, die durch die letzte unformatierte Eingabeoperation extrahiert wurden, oder der maximal darstellbare Wert von std::streamsize, wenn die Anzahl nicht darstellbar ist.

[bearbeiten] 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();
}

Ausgabe

Characters extracted: 11

[bearbeiten] 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 3464 C++98 der Rückgabewert war undefiniert, wenn das Ergebnis überlief gibt den Maximalwert zurück