#include <fstream>
  istream& getline( char* buffer, streamsize num );
  istream& getline( char* buffer, streamsize num, char delim );

The getline() function is used with input streams, and reads characters into buffer until either:

• num - 1 characters have been read,
• a newline is encountered,
• an EOF is encountered,
• or, optionally, until the character delim is read. The delim character is not put into buffer.

Those using a Microsoft compiler may find that getline() reads an extra character, and should consult the documentation on the Microsoft getline bug.