basic_istream::get
Ler um ou mais caracteres do 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 à leitura de strbuf._Delim
O caractere que deve terminar a leitura se for encontrada antes de _Count._Str
Uma cadeia de caracteres em que a gravação._Ch
Um caractere a ser obtido._Strbuf
Um buffer em que a gravação.
Valor de retorno
O formulário sem parâmetros de obtém retorna o elemento lido como um inteiro ou uma extremidade de arquivo. Os formulários outras retornam o fluxothis(*).
Comentários
O primeiro dessas funções de entrada sem formatação extrai um elemento, se possível, como se retornando rdbuf->sbumpc. Caso contrário, retorna traits_type::EOF. Se a função não extraem nenhum elemento, chama setstate(failbit).
A segunda função extrai o elemento meta de int_type a mesma maneira. Se meta compara o igual a traits_type::eof, as chamadas de função setstate(failbit). Caso contrário, o armazena traits_type::to_char_type(meta) 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 os armazena em uma matriz a partir de _Str. Armazena sempre char_type depois que alguns elementos que armazenar extraídos. Em ordem de teste, paradas de extração:
No final do arquivo.
Depois que a função extrai um elemento que compara o igual a _Delimnesse caso, o elemento é colocado novamente para a sequência controlada.
Após a função extrai _Count - elementos 1.
Se a função não extraem nenhum elemento, chama setstate(failbit). Em qualquer caso, retorna *this.
A quinta função retorna get(strbuf, widen('\ n)).
A sexta função extrai os elementos e inserir em strbuf. A extração para em participante de Arquivo ou um elemento que compara o igual a _Delim, que não é extraído. Também para, sem extrair o elemento em questão, se uma inserção falhará ou lance uma exceção (que será capturada mas não rethrown). Se a função não extraem nenhum elemento, chama setstate(failbit). Em qualquer caso, a função retornará *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
istream <deCabeçalho: >
Namespace: std