Libreria C ++ basic_ios - getline

Descrizione

Viene utilizzato per estrarre caratteri dal flusso come input non formattato e memorizzarli in s come una stringa c, fino a quando il carattere estratto è il carattere di delimitazione o n caratteri sono stati scritti in s (incluso il carattere null di terminazione).

Dichiarazione

Di seguito è riportata la dichiarazione per std :: basic_istream :: getline.

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

Parametri

  • s - Puntatore a una matrice di caratteri in cui i caratteri estratti vengono memorizzati come una stringa c.

  • n - Numero massimo di caratteri da scrivere in s (incluso il carattere null di terminazione).

  • delim - Carattere di delimitazione esplicito: l'operazione di estrazione dei caratteri successivi si interrompe non appena il carattere successivo da estrarre è uguale a questo (utilizzando traits_type :: eq).

Valore di ritorno

Restituisce l'oggetto basic_istream (* this).

Eccezioni

Basic guarantee - se viene generata un'eccezione, l'oggetto è in uno stato valido.

Gare di dati

Modifica gli elementi nell'array puntato da se l'oggetto stream.

Esempio

Nell'esempio seguente per 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;
}

L'output dovrebbe essere così -

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