basic_istream::get
Liest eine oder mehrere Zeichen im Eingabestream.
int_type get();
basic_istream<Elem, Tr>& get(
Elem& _Ch
);
basic_istream<Elem, Tr>& get(
Elem *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& get(
Elem *_Str,
streamsize _Count,
Elem _Delim
);
basic_istream<Elem, Tr>& get(
basic_streambuf<Elem, Tr>& _Strbuf
);
basic_istream<Elem, Tr>& get(
basic_streambuf<Elem, Tr>& _Strbuf,
Elem _Delim
);
Parameter
_Count
Die Anzahl der aus strbuf zu lesenden Zeichen._Delim
Das Zeichen, das das Lesen beenden soll, wenn sie vor _Count erreicht wird._Str
In der eine Zeichenfolge zu schreiben._Ch
Ein Zeichen abzurufen._Strbuf
In dem ein Puffer zu schreiben.
Rückgabewert
Das parameterlose Formular von rufen gibt das als ganze Zahl gelesene oder Dateiende Element ab.Die übrigen Formulare geben den Stream zurück (*this).
Hinweise
Das erste dieser unformatierten Eingabefunktionen extrahiert ein Element, wenn möglich, als ob, indem rdbuf- >sbumpc zurückgibt.Andernfalls wird traits_type::EOF zurück.Wenn die Funktion kein Element extrahiert, ruft sie setstate an (failbit).
Die zweite Funktion extrahiert das int_type-Element meta dieselbe Methode.Wenn meta gleich traits_type::eof vergleicht, die Funktionsaufrufe setstate(failbit).Andernfalls speichert es traits_type::to_char_type(meta) in _Ch.Die Funktion gibt *this zurück.
Die dritte Funktion gibt get zurück (_Str, _Count, widen("\n")).
Die vierte Funktion extrahiert bis zu _Count-Elemente 1 und speichert sie im Arrayanfang am _Str.Sie speichert immer char_type, nachdem alle extrahierten Elemente, die auf speichert.In der Reihenfolge der Tests Extraktionshalt:
An Dateiende.
Nachdem die Funktion ein Element extrahiert, das gleich _Delim vergleicht, in diesem Fall das Element an der gesteuerten Sequenz eingefügt wird.
Nach der Funktion extrahiert _Count-Elemente 1.
Wenn die Funktion keine Elemente extrahiert, ruft sie setstate an (failbit).In jedem Fall wird *this zurück.
Die fünfte Funktion gibt get zurück (strbuf, widen("\n")).
Die 6. Funktion extrahiert Elemente und fügt sie in strbuf ein.Extraktion beendet Dateiende oder ein Element auf, das gleich _Delim vergleicht , das nicht extrahiert wird.Sie wird auch auf, ohne das betreffende Element zu extrahieren, wenn eine Einfügung eine Ausnahme auslöst oder verlässt (die abgefangen wird, jedoch nicht erneut ausgelöst).Wenn die Funktion keine Elemente extrahiert, ruft sie setstate an (failbit).In jedem Fall gibt die Funktion *this zurück.
Beispiel
// basic_istream_get.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char c[10];
c[0] = cin.get( );
cin.get( c[1] );
cin.get( &c[2],3 );
cin.get( &c[4], 4, '7' );
cout << c << endl;
}
Anforderungen
Header: <istream>
Namespace: std