Partilhar via


basic_istream::read

Ler um número especificado de caracteres de fluxo e armazená-las em uma matriz.

Este método é potencialmente perigosos, porque depende do chamador para verificar se os valores passados estão corretos.

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

Parâmetros

  • _Str
    A matriz em que para ler caracteres.

  • _Count
    O número de caracteres a leitura.

Valor de retorno

o fluxo (*this).

Comentários

A função de entrada simples até count extrai os elementos e armazená-las no início de matriz em _Str.A extração para no início ao final de arquivo em esse caso, as chamadas de função setstatefailbit().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;
}
  abcde
  abcde
tipo “abcde”: abcde de abcde

Requisitos

Cabeçalho: <istream>

namespace: STD

Consulte também

Referência

basic_istream Class

iostream de programação

Convenções de iostreams