Extracts characters from stream until end of line or the specified delimiterdelim.

The first overload is equivalent togetline(s, count, widen('\n')).

Behaves asUnformattedInputFunction. After constructing and checking the sentry object, extracts characters from*this and stores them in successive locations of the array whose first element is pointed to bys, until any of the following occurs (tested in the order shown):

1. end of file condition occurs in the input sequence.
2. the next available characterc is the delimiter, as determined byTraits::eq(c, delim). The delimiter is extracted (unlikebasic_istream::get()) and counted towardsgcount(), but is not stored.
3. count is non-positive, orcount-1 characters have been extracted (setstate(failbit) is called in this case).

If the function extracts no characters, ​failbit is set in the local error state beforesetstate() is called.

In any case, ifcount>0, it then stores a null characterCharT() into the next successive location of the array and updatesgcount().

[edit]Notes

Because condition #2 is tested before condition #3, the input line that exactly fits the buffer does not triggerfailbit.

Because the terminating character is counted as an extracted character, an empty input line does not triggerfailbit.

[edit]Parameters

[edit]Return value

*this

[edit]Exceptions

If an internal operation throws an exception, it is caught andbadbit is set. Ifexceptions() is set forbadbit, the exception is rethrown.

[edit]Example

#include <array>#include <iostream>#include <sstream>#include <vector> int main(){std::istringstream input("abc|def|gh");std::vector<std::array<char,4>> v; // note: the following loop terminates when std::ios_base::operator bool()// on the stream returned from getline() returns falsefor(std::array<char,4> a; input.getline(&a[0],4,'|');)        v.push_back(a); for(auto& a: v)std::cout<<&a[0]<<'\n';}

abcdefgh

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文