Namensräume
Varianten
Aktionen

std::basic_streambuf<CharT,Traits>::showmanyc

Von cppreference.com
< cpp‎ | io‎ | basic streambuf
 
 
 
 
protected:
virtual std::streamsize showmanyc();

Schätzt die Anzahl der für die Eingabe in der zugehörigen Zeichensequenz verfügbaren Zeichen. underflow() garantiert, dass es nicht zurückkehrt Traits::eof() oder eine Ausnahme auslöst, bis mindestens so viele Zeichen extrahiert wurden.

Inhalt

[edit] Parameter

(keine)

[edit] Rückgabewert

Die Anzahl der Zeichen, die in der zugehörigen Zeichensequenz sicher verfügbar sind, oder -1, wenn showmanyc ohne Blockieren feststellen kann, dass keine Zeichen verfügbar sind. Wenn showmanyc -1 zurückgibt, werden underflow() und uflow() definitiv Traits::eof zurückgeben oder eine Ausnahme auslösen.

Die Basisklassenversion gibt 0 zurück, was die Bedeutung "unsicher, ob Zeichen in der zugehörigen Sequenz verfügbar sind" hat.

[edit] Hinweise

Der Name dieser Funktion steht für "stream: how many characters?" (Stream: wie viele Zeichen?), daher wird sie eher "S how many C" als "show many C" ausgesprochen.

[edit] Beispiel

[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 159 C++98 underflow() wird garantiert nicht fehlschlagen, bis
mindestens showmanyc() Zeichen bereitgestellt werden
die Garantie erweitert, um mindestens zu erlauben
showmanyc() Zeichen extrahiert werden

[edit] Siehe auch

holt die Anzahl der im Get-Bereich sofort verfügbaren Zeichen
(public member function) [edit]
[virtuell]
stellt optional die Anzahl der für die Eingabe aus der Datei verfügbaren Zeichen bereit
(virtual protected member function of std::basic_filebuf<CharT,Traits>) [edit]