Biblioteca de C ++ basic_ios - getline

Descripción

Se utiliza para extraer caracteres de la secuencia como entrada sin formato y almacenarlos en s como una cadena c, hasta que el carácter extraído sea el delimitador o se hayan escrito n caracteres en s (incluido el carácter nulo de terminación).

Declaración

A continuación se muestra la declaración 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 : Puntero a una matriz de caracteres donde los caracteres extraídos se almacenan como una cadena c.

  • n - Número máximo de caracteres para escribir en s (incluido el carácter nulo de terminación).

  • delim - Carácter delimitador explícito: La operación de extraer caracteres sucesivos se detiene tan pronto como el siguiente carácter a extraer se compara con este (usando traits_type :: eq).

Valor devuelto

Devuelve el objeto basic_istream (* this).

Excepciones

Basic guarantee - si se lanza una excepción, el objeto está en un estado válido.

Carreras de datos

Modifica los elementos de la matriz señalados por sy el objeto de flujo.

Ejemplo

En el siguiente ejemplo 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;
}

La salida debería ser así:

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