basic_istream (Clase)

Describe un objeto que controla la recuperación de elementos y objetos codificados de un búfer de la secuencia con elementos de Elemescrito, también conocido como char_type, cuyos rasgos de carácter se determinan mediante la clase Tr, también conocida como traits_type.

template <class Elem, class Tr = char_traits<Elem> > 
   class basic_istream 
      : virtual public basic_ios<Elem, Tr>

Comentarios

La mayoría de las funciones miembro que la sobrecarga operador ?>> es funciones de entrada con formato. Siguen el modelo:

    iostate state = goodbit;
    const sentry ok(*this);
    if (ok)
        {try
            {<extract elements and convert
            accumulate flags in state
            store a successful conversion> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);
    return (*this);

Muchas otras funciones miembro son funciones de entrada sin formato. Siguen el modelo:

    iostate state = goodbit;
    count = 0;    // the value returned by gcount
    const sentry ok(*this, true);
    if (ok)
        {try
            {<extract elements and deliver
            count extracted elements in count
            accumulate flags in state> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);

Dos grupos de llamada de funciones setstate(eofbit) si encuentra el fin de archivo mientras extraer elementos.

Un objeto de clase basic_istream<Elem, Tr> almacena:

  • Un objeto virtual del público de la clase basic_ios<Elem, Tr>.

  • Un recuento de recuperación para una operación sin formato de la última entrada (denominada count en el código anterior).

Ejemplo

Vea el ejemplo para basic_ifstream (Clase) para obtener más información sobre flujos de entrada.

Constructores

basic_istream

Construye un objeto de tipo basic_istream.

Funciones miembro

gcount

Devuelve el número de caracteres leído durante la entrada sin formato última.

obtener

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

getline

Lee una línea del flujo de entrada.

ignore

Produce varios elementos que se saltarán de la posición actual de lectura.

ojeada

Devuelve el carácter siguiente se leerá.

putback

Coloca un carácter especificado en la secuencia.

lectura

Lee un número especificado de caracteres de la secuencia y los almacena en una matriz.

readsome

Lectura de búfer únicamente.

seekg

Mueve la lectura colocar en una secuencia.

centinela

La clase anidada describe un objeto cuyas estructuras de declaración las funciones de entrada con formato y las funciones de entrada sin formato.

swap

Cambie este objeto de basic_istream para el parámetro de objeto proporcionado de basic_istream .

sincronización

Sincroniza el dispositivo de entrada asociado a la secuencia con el búfer de la secuencia.

tellg

Informes que la lectura posición actual en la secuencia.

unget

Coloca recientemente el carácter de lectura de nuevo en la secuencia.

Operadores

':?'.>>

Llama a una función en el flujo de entrada o lee datos con formato del flujo de entrada.

operator=

Asigna basic_istream a la derecha del operador a este objeto. Esto es una asignación de movimiento que contenga una referencia de rvalue que no permite una copia subyacente.

Requisitos

Istream<deHeader: >

Espacio de nombres: std

Vea también

Referencia

Seguridad para subprocesos en la biblioteca estándar de C++

Programación con iostream

Convenciones de iostreams

Otros recursos

miembros de basic_istream

miembros de <istream>