Freigeben über


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 außerdem 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 N-Elemente 1 und speichert sie im Array beginnend beim _Str. Wenn _Istr.Breite ist größer, als null, N_Istr ist.width; Andernfalls befindet es die Größe des größten Arrays von Elem, die deklariert werden kann. Die Funktion immer Elem() speichert den Wert, nachdem alle extrahierten Elemente, die in ihm gespeichert. Suche beendet früh Dateiende, auf ein Zeichen mit Wert Elem(0) (der nicht extrahiert wird) bzw. in einem Element (das nicht extrahiert wird), das vom LR verworfen wird. Wenn die Funktion keine Elemente extrahiert, ruft sie _Istr auf.setstate(failbit). Auf jeden Fall ruft sie _Istr auf.width(0) und gibt _Istr.

Sicherheitshinweis Die auf NULL abschließende Zeichenfolge, die aus dem 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 es in _Ch. Andernfalls ruft es is auf.setstate(failbit). Auf jeden Fall gibt jedoch _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
   );

_Istr gibt >> _Val zurück (und konvertiert rvalue reference in _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

Ausgabe

12345678

Anforderungen

Header: <istream>

Namespace: std

Siehe auch

Referenz

basic_istream::operator>>

iostream-Programmierung

iostreams-Konventionen