Compartilhar via


basic_istream::get

Ler um ou mais caracteres de fluxo 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
    O número de caracteres a leitura de strbuf.

  • _Delim
    O caractere que deve finalizar a leitura se ele está localizado antes de _Count.

  • _Str
    Uma cadeia de caracteres em que a gravação.

  • _Ch
    Um caractere para obter.

  • _Strbuf
    Um buffer em que a gravação.

Valor de retorno

O formulário sem parâmetros de obtém o elemento como ler retorna um inteiro ou fim de arquivo.Os outros formulários retornam o fluxo (*)this.

Comentários

O primeiro de essas funções de entrada sem formatação em um elemento, se possível, como se retornando rdbuf- >sbumpc.Caso contrário, retornará traits_type::EOF.Se a função não em qualquer elemento, chama setstatefailbit().

A segunda função no elemento meta de int_type a mesma maneira.Se meta compara igual a traits_type::eof, as chamadas de função setstatefailbit().Caso contrário, armazena traits_type::to_char_typemeta() em _Ch.a função retorna *this.

A terceira função retorna get(_Str, _Count, widen('\n')).

A quarta função extrai até _Count - 1 elementos e armazená-las no início da matriz em _Str.Sempre armazena char_type após quaisquer elementos que extraídos armazenar.Por ordem de teste, paradas de extração:

  • Em o final do arquivo.

  • Depois que a função extrai um elemento que compare igual a _Delimem esse caso, o elemento é colocado de volta para a seqüência controlada.

  • Após a função em _Count - 1 elementos.

Se a função não em qualquer elemento, chama setstatefailbit().Em qualquer caso, retorna *this.

A quinta função retorna get(strbuf, widen(“")n\).

a sexta função extrai os elementos e inserir-los em strbuf.A extração para no final de Arquivo ou um elemento que compare igual ao _Delim*,* que não é extraído.Também para, sem extrair o elemento em questão, se uma inserção ou falha gera uma exceção (que é detectada mas não rethrown).Se a função não em qualquer elemento, chama setstatefailbit().Em qualquer caso, a função retorna *this.

Exemplo

// 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

Cabeçalho: <istream>

namespace: STD

Consulte também

Referência

basic_istream Class

iostream de programação

Convenções de iostreams