Partilhar via


basic_istream::read

Lê um número especificado de caracteres de fluxo e armazená-los em uma matriz.

Esse método é potencialmente não seguro, porque depende do chamador para verifica se os valores passados estão corretos.

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

Parâmetros

  • _Str
    A matriz na qual deve-se ler os caracteres.

  • _Count
    O número de caracteres a serem lidos.

Valor de retorno

O fluxo (*this).

Comentários

A função de entrada sem formatação extrai até count os elementos e os armazena na matriz em _Str. A extração para no início ao fim do arquivo, caso em que as chamadas de função setstate(failbit). Em qualquer caso, retorna *this.

Exemplo

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

FakePre-965cd7bbf6114263b9bde93a8cfab683-6d6f3fac260744ad9700ab6a8a3c1b05

Requisitos

istream <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe basic_istream

Programação iostream

Convenções iostreams