Share via


operator>> (<string>)

Una función de plantilla que lee una cadena de un flujo 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
    El flujo de entrada se utiliza para extraer la secuencia

  • _Right
    La cadena que está siendo extraída del flujo de entrada.

Valor devuelto

Lee el valor de cadena especificado de _Istr y lo devuelve en _Right.

Comentarios

El operador omite los espacios en blanco iniciales a menos que se establezca el marcador de skipws . Lee todos los caracteres siguientes hasta que el siguiente carácter es un espacio en blanco o el final del archivo se alcance.

La función de plantilla sobrecarga operador ?>> para reemplazar la secuencia controlada por _Right con una secuencia de elementos de la secuencia _Istr. La recuperación se detiene:

  • Al final del archivo.

  • Después de la función extrae _Istr. elementos dewidth , si el valor es distinto de cero.

Después de la función extrae _Istr. elementos demax_size .

  • Después de que la función extrae un elemento ch para el que use_facet<ctype<CharType> >( getloc). is(::<space, chde ctypeCharType>) es true, en cuyo caso el carácter se devuelve put.

Si la función no extrae ningún elemento, llama a setstate(ios_base::failbit). En cualquier caso, llama a istr.width(0) y devuelve *this.

Ejemplo

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

Resultados del ejemplo

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

Requisitos

Encabezado: <string>

Espacio de nombres: std

Vea también

Referencia

string::operator>>