Freigeben über


basic_istream::get

Liest ein 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 zum Lesen beendet werden soll, wenn es vor _Count erreicht wird.

  • _Str
    In der eine Zeichenfolge zu schreiben.

  • _Ch
    Ein Zeichen abzurufen.

  • _Strbuf
    In dem Puffer zu schreiben.

Rückgabewert

Das Formular gibt von parameterlose rufen das als ganze Zahl oder gelesene Dateiende Element ab. Die verbleibenden Formate geben den Stream mit * (this).

Hinweise

Das erste dieser häufig Eingabefunktionen extrahiert ein Element, wenn möglich, als ob, indem Sie rdbuf->sbumpc zurückgibt. Andernfalls gibt es traits_type::EOF zurück. Wenn die Funktion kein Element extrahiert, ruft sie auf setstate(failbit).

Die zweite Funktion extrahiert das int_type-Element meta dieselbe Methode. Wenn meta gleich traits_type::eof vergleicht, die Funktionsaufrufe setstate(failbit). Andernfalls werden die traits_type::to_char_type(meta) in _Ch. Die Funktion gibt *this zurück.

Die dritte Funktion gibt abrufen zurück (_Str, _Count, widen('\n')).

Die vierte Funktion extrahiert bis _Count-Elemente 1 und speichert sie im Arrayanfang am _Str. Sie speichert immer char_type, nachdem alle extrahierten Elemente, die es speichert. In der Reihenfolge der Tests Extraktionshalt:

  • An Dateiende.

  • Nachdem die Funktion ein Element extrahiert, das gleich _Delim vergleicht, in diesem Fall das Element zurück zur gesteuerten Reihenfolge platziert wird.

  • Nach der Funktion extrahiert _Count-Elemente 1.

Wenn die Funktion keine Elemente extrahiert, ruft sie setstate(failbit). Auf jeden Fall gibt diese *this zurück.

Die fünfte Funktion gibt abrufen zurück (strbuf, widen('\n')).

Die Funktion. 6 Elemente extrahiert und fügt sie in strbuf ein. Suche beendet Dateiende oder ein Element auf, das gleich _Delim vergleicht , das nicht extrahiert wird. Sie wird auch auf, ohne das jeweilige Element zu extrahieren, wenn eine Ausnahme eine Einfügung verlässt oder auslöst (die abgefangen wurde, die nicht erneut ausgelöst). Wenn die Funktion keine Elemente extrahiert, ruft sie setstate(failbit). Auf jeden Fall gibt die *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

Siehe auch

Referenz

basic_istream-Klasse

iostream-Programmierung

iostreams-Konventionen