Standard C++ Library Reference ISO/IEC (VERSION3)

str. It always stores char_type() after any extracted elements it stores. In order of testing,
extraction stops:
at end of file1.
after the function extracts an element that compares equal to delim, in which case the
element is put back to the controlled sequence
2.
after the function extracts count - 1 elements3.
If the function extracts no elements, it calls setstate(failbit). In any case, it returns
*this.
The fifth function returns get(strbuf, widen('\n')).
The sixth function extracts elements and inserts them in strbuf. Extraction stops on end-of-file
or on an element that compares equal to delim (which is not extracted). It also stops, without
extracting the element in question, if an insertion fails or throws an exception (which is caught but
not rethrown). If the function extracts no elements, it calls setstate(failbit). In any case,
the function returns *this.
basic_istream::getline
basic_istream& getline(char_type *str, streamsize count);
basic_istream& getline(char_type *str, streamsize count,
char_type delim);
The first of these unformatted input functions returns getline(str, count,
widen('\n')).
The second function extracts up to count - 1 elements and stores them in the array beginning
at str. It always stores char_type() after any extracted elements it stores. In order of testing,
extraction stops:
at end of file1.
after the function extracts an element that compares equal to delim, in which case the
element is neither put back nor appended to the controlled sequence
2.
after the function extracts count - 1 elements3.
If the function extracts no elements or count - 1 elements, it calls setstate(failbit). In
any case, it returns *this.
basic_istream::ignore
basic_istream& ignore(streamsize count = 1,
int_type delim = traits_type::eof());
The unformatted input function extracts up to count elements and discards them. If count
equals numeric_limits<int>::max(), however, it is taken as arbitrarily large. Extraction
stops early on end-of-file or on an element ch such that traits_type::to_int_type(ch)