Operadores de <istream><istream> operators

Operator>>operator>>

Extrae caracteres y cadenas del flujo.Extracts characters and strings from the 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);

ParámetrosParameters

CamCh
Un carácter.A character.

ISTRIstr
Flujo.A stream.

CADstr
Una cadena.A string.

Valval
Un tipo.A type.

Valor devueltoReturn Value

Flujo.The stream

ObservacionesRemarks

La clase basic_istream también define varios operadores de extracción.The basic_istream class also defines several extraction operators. Para obtener más información, vea basic_istream::operator>>.For more information, see basic_istream::operator>>.

La plantilla de función:The function template:

template <class Elem, class Tr>
basic_istream<Elem, Tr>& operator>>(
    basic_istream<Elem, Tr>& Istr, Elem* str);

Extrae N - 1 los elementos y los almacena en la matriz a partir de Str.extracts up to N - 1 elements and stores them in the array starting at str. Si el Istr. ancho es mayor que cero, N es Istr.width ; en caso contrario, es el tamaño de la matriz más grande de Elem que se puede declarar.If Istr.width is greater than zero, N is Istr.width; otherwise, it's the size of the largest array of Elem that can be declared. La función siempre almacena el valor Elem() después de los elementos extraídos que almacena.The function always stores the value Elem() after any extracted elements it stores. La extracción se detiene anticipadamente al final del archivo, en un carácter con valor Elem(0) (que no se extrae) o en cualquier elemento (que no se extrae) que se descartará mediante WS.Extraction stops early on end of file, on a character with value Elem(0) (which isn't extracted), or on any element (which isn't extracted) that would be discarded by ws. Si la función no extrae ningún elemento, llama a Istr. setstate (failbit) .If the function extracts no elements, it calls Istr.setstate(failbit). En cualquier caso, llama a Istr.width(0) y devuelve ISTR.In any case, it calls Istr.width(0) and returns Istr.

Nota de seguridad La cadena terminada en null que se va a extraer del flujo de entrada no debe superar el tamaño del búfer de destino Str.Security Note The null-terminated string being extracted from the input stream must not exceed the size of the destination buffer str. Para obtener más información, vea Avoiding Buffer Overruns(Evitar saturaciones del búfer).For more information, see Avoiding Buffer Overruns.

La plantilla de función:The function template:

template <class Elem, class Tr>
basic_istream<Elem, Tr>& operator>>(
    basic_istream<Elem, Tr>& Istr, Elem& Ch);

extrae un elemento, si es posible, y lo almacena en CH.extracts an element, if possible, and stores it in Ch. De lo contrario, llama a is. setstate (failbit) .Otherwise, it calls is.setstate(failbit). En cualquier caso, devuelve ISTR.In any case, it returns Istr.

La plantilla de función:The function template:

template <class Tr>
basic_istream<char, Tr>& operator>>(
    basic_istream<char, Tr>& Istr, signed char* str);

Devuelve Istr >> ( char * ) str.returns Istr >> ( char * ) str.

La plantilla de función:The function template:

template <class Tr>
basic_istream<char, Tr>& operator>>(
    basic_istream<char, Tr>& Istr, signed char& Ch);

Devuelve Istr >> ( char& ) Ch.returns Istr >> ( char& ) Ch.

La plantilla de función:The function template:

template <class Tr>
basic_istream<char, Tr>& operator>>(
    basic_istream<char, Tr>& Istr, unsigned char* str);

Devuelve Istr >> ( char * ) str.returns Istr >> ( char * ) str.

La plantilla de función:The function template:

template <class Tr>
basic_istream<char, Tr>& operator>>(
    basic_istream<char, Tr>& Istr, unsigned char& Ch);

Devuelve Istr >> ( char& ) Ch.returns Istr >> ( char& ) Ch.

La plantilla de función:The function template:

template <class Elem, class Tr, class Type>
basic_istream<Elem, Tr>& operator>>(
    basic_istream<char, Tr>&& Istr,
    Type& val);

Devuelve Istr >> val (y convierte una referencia rvalue en Istr a un valor l en el proceso).returns Istr >> val (and converts an rvalue reference to Istr to an lvalue in the process).

EjemploExample

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

Consulte tambiénSee also

<istream>