Partilhar via


operator>> (<istream>)

Caracteres e cadeias de caracteres de extratos de fluxo.

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
    );

Parâmetros

  • _Ch
    Um caractere.

  • _Istr
    Um fluxo.

  • _Str
    Uma cadeia de caracteres.

  • _Val
    Um tipo.

Valor de retorno

o fluxo

Comentários

A classe de basic_istream também define vários operadores de extração.Para mais informações, consulte basic_istream::operator>>.

A função do modelo:

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

extrai até N - 1 elementos e armazená-las na matriz que começa em _Str.Se _Istr.largura é maior que zero, Em são _Istr.width; caso contrário, o tamanho da matriz é maior de Elem que pode ser declarada.A função sempre armazena o valor Elem() após quaisquer elementos que extraídos armazenar.A extração para no início ao final do arquivo, em um caractere com valor Elem(0) a (que não é extraído), ou em qualquer elemento (que não é extraído) que seria descartados por WS.Se a função não em qualquer elemento, chama _Istr.setstatefailbit().Em qualquer caso, chama _Istr.width(0) e retorna _Istr.

Security Note a cadeia de caracteres NULL- finalizada que está sendo extraída de fluxo de entrada não pode exceder o tamanho do buffer _Strde destino.Para obter mais informações, consulte Evitando estouros de buffer.

A função do modelo:

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

extrai um elemento, se possível, e o armazena em _Ch.Caso contrário, chama is.setstatefailbit().Em qualquer caso, retorna _Istr.

A função do modelo:

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

retorna _Istr >> (char*****)_Str.

A função do modelo:

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

retorna _Istr >> (char&)_Ch.

A função do modelo:

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

retorna _Istr >> (char *)_Str.

A função do modelo:

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

retorna _Istr >> (char&)_Ch.

A função do modelo:

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

retorna _Istr>>_Val (e converte rvalue reference a _Istr a lvalue no processo).

Exemplo

// 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;
}

Entrada

1234567890

Saída

12345678

Requisitos

Cabeçalho: <istream>

namespace: STD

Consulte também

Referência

basic_istream::operator>>

iostream de programação

Convenções de iostreams