basic_istream::get

Lee uno o más caracteres del flujo de entrada.

int_type get();
basic_istream<Elem, Tr>& get(
    Elem& _Ch
);
basic_istream<Elem, Tr>& get(
    Elem *_Str,
    streamsize _Count
);
basic_istream<Elem, Tr>& get(
    Elem *_Str,
    streamsize _Count,
    Elem _Delim
);
basic_istream<Elem, Tr>& get(
    basic_streambuf<Elem, Tr>& _Strbuf
);
basic_istream<Elem, Tr>& get(
    basic_streambuf<Elem, Tr>& _Strbuf,
    Elem _Delim
);

Parámetros

_Count
Número de caracteres que se van a leer del strbuf.
_Delim
el carácter que debe finalizar la lectura si se encuentra antes de _Count.
_Str
Una cadena en la que se va a escribir.
_Ch
Un carácter a recopilar.
_Strbuf
Un búfer en el que se va a escribir.

Valor devuelto

El formulario sin parámetros de get devuelve el elemento leído como un entero o final de archivo.Formularios restantes devuelven la secuencia (*this).

Comentarios

El primer de estas funciones de entrada sin formato extrae un elemento, si es posible, como si devuelve rdbuf- >sbumpc.De lo contrario, devuelve traits_type::EOF.Si la función no extrae ningún elemento, llama a setstate(failbit).

la segunda función extrae el elemento meta de int_type la misma manera.Si meta es igual a traits_type:: EOF, la función setstate(failbit).si no, almacena traits_type::to_char_type(meta) en _Ch.la función devuelve *this.

la tercera función devuelve obtenga(_Str, _Count, widen(“\n")).

La cuarta función extrae hasta _Count (elementos 1 y los almacena en el principio de la matriz en el _Str.Almacena siempre char_type después de que los elementos extraídos que almacena.En orden de pruebas, la recuperación se detiene:

Al final del archivo.
Después de que la función extrae un elemento que comparar el igual a _Delim, en cuyo caso el elemento se coloca a la secuencia controlada.
después de la función extrae _Count - elementos 1.

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

la quinta función devuelve obtenga(strbuf, widen(“\n")).

La sexta función extrae los elementos y los inserta en strbuf.La recuperación se detiene en el fin de archivo o en un elemento que comparar igual que el _Delim*,* que no se extraen.También detiene, sin extraer el elemento en cuestión, si una inserción con errores o produce una excepción (se detecte que pero no vuelve).Si la función no extrae ningún elemento, llama a setstate(failbit).En cualquier caso, la función devuelve *this.

Ejemplo

// basic_istream_get.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main( ) 
{
   char c[10];

   c[0] = cin.get( );
   cin.get( c[1] );
   cin.get( &c[2],3 );
   cin.get( &c[4], 4, '7' );

   cout << c << endl;
}

Requisitos

encabezado: <istream>

espacio de nombres: std

Vea también

Referencia

basic_istream Class

programación iostream

convenciones de iostreams

Last updated on 2013-03-15