basic_istream::read

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

Este método es potencialmente peligroso, como se basa en el llamador para comprobar que los valores pasados son correctos.

basic_istream<Elem, Tr>& read(
    char_type *_Str, 
    streamsize _Count
);

Parámetros

• _Str
  La matriz en el que para leer los caracteres.

• _Count
  Número de caracteres que se va a leer.

Valor devuelto

la secuencia (*this).

Comentarios

La función de entrada sin formato extrae hasta count elementos y los almacena en el principio de la matriz en _Str.Extracción detiene el principio final del archivo, en este caso las llamadas de función setstate(failbit).En cualquier caso, devuelve *this.

Ejemplo

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

int main()
{
    char c[10];
    int count = 5;

    cout << "Type 'abcde': ";

    // Note: cin::read is potentially unsafe, consider
    // using cin::_Read_s instead.
    cin.read(&c[0], count);
    c[count] = 0;

    cout << c << endl;
}

  abcde

  abcde
tipo “abcde”: abcde de abcde

Requisitos

encabezado: <istream>

espacio de nombres: std

Vea también

Referencia

basic_istream Class

programación iostream

convenciones de iostreams