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:
- Verschiebekonstruktor
- swap()
- get()
- getline()
- ignore()
- read()
- readsome()
- operator>>(basic_streambuf*)
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
Führen Sie diesen Code aus
#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 |