Partilhar via


operator>> (<string>)

Uma função do modelo que lê uma cadeia de caracteres de um fluxo de entrada.

template<class CharType, class Traits, class Allocator>
   basic_istream<CharType, Traits>& operator>>(
      basic_istream<CharType, Traits>& _Istr,
      basic_string<CharType, Traits, Allocator>& _Right
   );

Parâmetros

  • _Istr
    O fluxo de entrada usado para extrair a sequência

  • _Right
    A cadeia de caracteres que está sendo extraídos do fluxo de entrada.

Valor de retorno

Ler o valor da cadeia de caracteres especificada de _Istr e o retorna em _Right.

Comentários

O operador irá ignorar os espaços em branco à esquerda a menos que o sinalizador de skipws é definido. Ler todos os seguintes caracteres até que o próximo caractere é um espaço em branco ou ao final do arquivo for atingida.

A função do modelo sobrecarregar operator>> para substituir a sequência controlada por _Right com uma sequência de elementos de fluxo _Istrextraídos. Paradas de extração:

  • No final do arquivo.

  • Após a função extrai _Istr. elementos dewidth , se esse valor for diferente de zero.

Após a função extrai _Istr. elementos demax_size .

  • Depois que a função extrai um elemento ch para que use_facet<ctype<CharType> >( getloc). is(::<spacede ctypeCharType>, ch) é true, caso em que o caractere tiver sido colocado.

Se a função não extraem nenhum elemento, chama setstate(ios_base::failbit). Em qualquer caso, chama istr.width(0) e retornará *this.

Exemplo

// string_op_read_.cpp
// compile with: /EHsc
#include <string>
#include <iostream>

int main( )
{
   using namespace std;

   string c0;
   cout << "Input a string c0 ( try: Fibonacci numbers ): ";
   cin >> c0;
   cout << "The string entered is c0 = " << c0 << endl;
}

Entrada

Fibonacci numbers

Saída de Exemplo

Input a string c0 ( try: Fibonacci numbers ): Fibonacci numbers
The string entered is c0 = Fibonacci

Requisitos

Cabeçalho: <cadeia de caracteres>

Namespace: std

Consulte também

Referência

string::operator>>