Biblioteca C ++ basic_ios - getline

Descrição

É usado para extrair caracteres do fluxo como entrada não formatada e armazená-los em s como uma string C, até que o caractere extraído seja o caractere delimitador ou n caracteres tenham sido gravados em s (incluindo o caractere nulo de terminação).

Declaração

A seguir está a declaração para std :: basic_istream :: getline.

basic_istream& getline (char_type* s, streamsize n );
basic_istream& getline (char_type* s, streamsize n, char_type delim);

Parâmetros

  • s - Ponteiro para uma matriz de caracteres onde os caracteres extraídos são armazenados como uma string C.

  • n - Número máximo de caracteres a serem gravados em s (incluindo o caractere nulo de terminação).

  • delim - Caractere delimitador explícito: A operação de extração de caracteres sucessivos para assim que o próximo caractere a ser extraído for igual a este (usando traits_type :: eq).

Valor de retorno

Retorna o objeto basic_istream (* this).

Exceções

Basic guarantee - se uma exceção for lançada, o objeto está em um estado válido.

Corridas de dados

Modifica os elementos na matriz apontada por seo objeto stream.

Exemplo

No exemplo abaixo para std :: basic_istream :: getline.

#include <iostream>

int main () {
   char name[256], title[256];

   std::cout << "Please, enter your name: ";
   std::cin.getline (name,256);

   std::cout << "Please, enter your favourite movie: ";
   std::cin.getline (title,256);

   std::cout << name << "'s favourite movie is " << title;

   return 0;
}

A saída deve ser assim -

Please, enter your name: tutorialspoint
Please, enter your favourite movie: ted
tutorialspoint's favourite movie is ted