std::basic_streambuf<CharT,Traits>::showmanyc
| 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
| Dieser Abschnitt ist unvollständig Grund: kein 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 erlaubenshowmanyc() Zeichen extrahiert werden |
[edit] Siehe auch
| holt die Anzahl der im Get-Bereich sofort verfügbaren Zeichen (public member function) | |
| [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>) |