getline
Extrai seqüências de caracteres da fluxo de entrada linha por linha.
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>& _Istr,
basic_string<CharType, Traits, Allocator>& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream< CharType, Traits >& getline(
basic_istream< CharType, Traits >& _Istr,
basic_string< CharType, Traits, Allocator >& _Str,
CharType _Delim
);
template<class Allocator, class Traits, class Allocator>
basic_istream< Allocator, Traits >& getline(
basic_istream< Allocator, Traits >&& _Istr,
basic_string< Allocator, Traits, Allocator >& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>&& _Istr,
basic_string<CharType, Traits, Allocator>& _Str,
const CharType _Delim
);
Parâmetros
_Istr
O fluxo de entrada da qual é uma seqüência de caracteres a serem extraídos._Str
A seqüência em que é lidos os caracteres do fluxo de entrada._Delim
O delimitador de linha.
Valor de retorno
The first function returns getline( _Istr, _Str, _Istr.widen( '\n' ) ).
A segunda função substitui a seqüência controlada por _Str com uma seqüência de elementos extraídos do fluxo de _Istr.
As funções restantes são análogos aos anteriores, mas com Lvalues e Rvalues.
Comentários
Em ordem de teste, pára de extração:
No fim do arquivo.
Depois que a função extrai um elemento que compara igual a delim, caso em que o elemento não é colocado de volta nem acrescentado à seqüência controlada.
Depois que a função extrai str.max_size elementos, em que as chamadas de função de caso setstate(ios_base::failbit).
Se a função não extrai nenhum elemento, ele chama setstate(failbit).Em qualquer caso, ele retorna _Istr.
Exemplo
Consulte string::getline para obter um exemplo do uso de getline.
Requisitos
Cabeçalho: <string>
Namespace: std