basic_istream::getline
Obtém uma linha do fluxo de entrada.
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count,
char_type _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.
Valor de retorno
O fluxo (*this).
Comentários
A primeira dessas funções de entrada sem formatação retornará getline(_Str, _Count, widen('\n')).
A segunda função extrai até _Count - 1 elementos e os armazena em uma matriz a partir de _Str. Armazena sempre o caractere de término da cadeia de caracteres 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 não é colocado novamente ou acrescentado a sequência controlada.
Após a função extrai _Count - elementos 1.
Se a função não extraem nenhum elemento ou _Count - 1 elementos, chama setstate(failbit). Em qualquer caso, retorna *this.
Exemplo
// basic_istream_getline.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char c[10];
cin.getline( &c[0], 5, '2' );
cout << c << endl;
}
Requisitos
istream <deCabeçalho: >
Namespace: std