Partilhar via


basic_istream::getline

Obtém uma linha de 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 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.

Valor de retorno

o fluxo (*this).

Comentários

A primeira dessas funções de entrada sem formatação retorna getline(_Str, _Count, widen('\n')).

A segunda função extrai até _Count - 1 elementos e armazená-las no início da matriz em _Str.Sempre armazena o caractere de fim da cadeia de caracteres 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 ou voltar ou acrescentado à seqüência controlada.

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

Se a função não em qualquer elemento ou _Count - 1 elementos, chama setstatefailbit().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

Cabeçalho: <istream>

namespace: STD

Consulte também

Referência

basic_istream Class

iostream de programação

Convenções de iostreams