cpp/string/basic string/getline

reads characters from an input stream and places them into a string:

@1-2@ Behaves as, except that is not affected. After constructing and checking the sentry object, performs the following:
 * @1@ Calls
 * @2@ Extracts characters from and appends them to  until one of the following occurs (checked in the order listed)
 * @a@ end-of-file condition on, in which case, sets.
 * @b@ the next available input character is, as tested by , in which case the delimiter character is extracted from , but is not appended to.
 * @c@ characters have been stored, in which case  sets  and returns.
 * @3@ If no characters were extracted for whatever reason (not even the discarded delimiter), sets  and returns.

@3-4@ Same as, that is, the default delimiter is the endline character.