43

When should std::cin.getline() be used? What does it differ from std::cin?

Trevor Hickey
  • 36,288
  • 32
  • 162
  • 271
Simplicity
  • 47,404
  • 98
  • 256
  • 385

5 Answers5

45

Let's take std::cin.getline() apart. First, there's std::. This is the namespace in which the standard library lives. It has hundreds of types, functions and objects.

std::cin is such an object. It's the standard character input object, defined in <iostream>. It has some methods of its own, but you can also use it with many free functions. Most of these methods and functions are ways to get one or more characters from the standard input.

Finally, .getline() is one such method of std::cin (and other similar objects). You tell it how many characters it should get from the object on its left side (std::cin here), and where to put those characters. The precise number of characters can vary: .getline() will stop in three cases: 1. The end of a line is reached 2. There are no characters left in the input (doesn't happen normally on std::cin as you can keep typing) 3. The maximum number of characters is read.

There are other methods and functions that can be used with the std::cin object, e.g.

  std::string s;
  int i;
  std::cin >> s; // Read a single word from std::cin
  std::cin >> i; // Read a single number from std::cin
  std::getline(std::cin, s); // Read an entire line (up to \n) from std::cin
  std::cin.ignore(100); // Ignore the next 100 characters of std::cin
Brendan Abel
  • 35,343
  • 14
  • 88
  • 118
MSalters
  • 173,980
  • 10
  • 155
  • 350
24

In case with char*, std::cin.getline getting line, instead of std::cin getting first word.

alvelcom
  • 388
  • 2
  • 4
  • 14
    I don't understand this answer. `std::cin` doesn't get anything; it's just an object. You have to do something with it (e.g. call a member function like `get`) before it does anything. – CB Bailey Jan 20 '11 at 10:56
  • 1
    `char s1[256], s2[256]; std::cin >> s1; cin.getline(s2, 256);` – alvelcom Jan 20 '11 at 11:14
  • 5
    `std::cin >> s1` is a call to a global function `istream& operator>> (istream&, char*)` – eq- Jan 20 '11 at 11:22
  • 1
    This answer needs to be edited. The wording and explanation are confusing – Arjuna Deva Apr 19 '21 at 13:02
10

Did you read any documentation (e.g. http://www.cplusplus.com/reference/string/getline/)?

Basically, std::cin (or more generally, any std::istream) is used directly in order to obtain formatted input, e.g. int x; std::cin >> x;. std::cin.getline() is used simply to fill a raw char * buffer.

Oliver Charlesworth
  • 267,707
  • 33
  • 569
  • 680
4

(Very simplefied)My answer is, that std :: cin.getline() can contain spaces, while std :: cin >> can not.

B0rKII
  • 51
  • 1
1

As already others have answered (even better) roughly speaking, use getline() to read an entire line (i.e., a string terminating with \n) and cin>>var to read a number compatible with the type of var (integer, float, double etc.) or a single word.

In this answer I want to emphasize a problem that arises when mixing the two methods. When you do:

int a;
string s;
cin>>a;
getline(cin, s)

cin leaves an end of line, \n, character which is then read by getline();. It is possible to overcome this problem by using cin.ignore().

int a;
string s;
cin>>a;
cin.ignore();
getline(cin, s)
roschach
  • 8,390
  • 14
  • 74
  • 124
  • `cin.ignore()` will only discard a single character, whereas `cin.ignore( std::numeric_limits::max(), '\n' );` will discard the rest of the line, including the newline character. It doesn't seem meaningful to use `cin.ignore()` in this case, because `cin>>a` will only read a single word. Therefore, you cannot assume that the next character will be the newline character. – Andreas Wenzel May 11 '21 at 15:28