operator>> (<istream>)

Auszugzeichen und Zeichenfolgen vom Stream.

template<class Elem, class Tr>
    basic_istream<Elem, Tr>& operator>>(
        basic_istream<Elem, Tr>& _Istr, 
        Elem *_Str
    );
template<class Elem, class Tr>
    basic_istream<Elem, Tr>& operator>>(
        basic_istream<Elem, Tr>& _Istr, 
        Elem& _Ch
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        signed char *_Str
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        signed char& _Ch
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        unsigned char *_Str
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        unsigned char& _Ch
    );
template<class Elem, class Tr, class Type>
    basic_istream<Elem, Tr>& operator>>(
        basic_istream<char, Tr>&& _Istr,
        Type& _Val
    );

Parameter

  • _Ch
    Ein Zeichen.

  • _Istr
    Ein Stream.

  • _Str
    Eine Zeichenfolge.

  • _Val
    Ein Typ.

Rückgabewert

Der Stream

Hinweise

Die basic_istream-Klasse definiert auch einige Extraktionsoperatoren.Weitere Informationen finden Sie unter basic_istream::operator>>.

Die Vorlagenfunktion:

template<class Elem, class Tr>
   basic_istream<Elem, Tr>& operator>>(
      basic_istream<Elem, Tr>& _Istr, Elem *_Str);

Auszüge bis zu N-Elemente 1 und speichert sie im Array beginnend beim _Str.Wenn _Istr.Breite, ist größer als null, N_Istr ist.Breite; andernfalls ist es die Größe des größten Arrays von Elem, das deklariert werden kann.Die Funktion speichert immer den Wert Elem(), nachdem alle extrahierten Elemente, die ihm gespeichert.Extraktion beendet früh Dateiende, auf einem Zeichen mit Wert Elem(0) (der nicht extrahiert wird) oder auf einem beliebigen Element (das nicht extrahiert wird), das von LR verworfen wird.Wenn die Funktion keine Elemente extrahiert, ruft sie _Istr an.setstate(failbit).In jedem Fall ruft sie _Istr an.Breite(0) und gibt _Istr.

Security Note die auf NULL endende Zeichenfolge, die im Eingabestream extrahiert wird, darf die Größe des Zielpuffers _Str nicht überschreiten.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

Die Vorlagenfunktion:

template<class Elem, class Tr>
   basic_istream<Elem, Tr>& operator>>(
      basic_istream<Elem, Tr>& _Istr, Elem& _Ch);

extrahiert ein Element, wenn es möglich ist, und speichert sie in _Ch.Andernfalls wird is an.setstate(failbit).In jedem Fall gibt es _Istr zurück.

Die Vorlagenfunktion:

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, signed char *_Str);

gibt _Istr >> (char*****)_Str zurück.

Die Vorlagenfunktion:

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, signed char& _Ch);

gibt _Istr >> (char&)_Ch zurück.

Die Vorlagenfunktion:

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, unsigned char *_Str);

gibt _Istr >> (char *)_Str zurück.

Die Vorlagenfunktion:

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, unsigned char& _Ch);

gibt _Istr >> (char&)_Ch zurück.

Die Vorlagenfunktion:

template<class Elem, class Tr, class Type>
   basic_istream<Elem, Tr>& operator>>(
      basic_istream<char, Tr>&& _Istr,
      Type& _Val
   );

gibt _Istr>>_Val zurück (und konvertiert rvalue reference zu _Istr zu lvalue im Prozess).

Beispiel

// istream_op_extract.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main( ) 
{
   ws( cin );
   char c[10];

   cin.width( 9 );
   cin >> c;
   cout << c << endl;
}

Eingabe

1234567890

Output

12345678

Anforderungen

Header: <istream>

Namespace: std

Siehe auch

Referenz

basic_istream::operator>>

Programmierung der iostream-Headerdatei

iostreams Konventionen