21 Strings library [strings]

Effects: Equivalent to:

basic_string<charT, traits, Allocator> r = lhs;
r.append(rhs);
return r;

Effects: Equivalent to:

lhs.append(rhs);
return std::move(lhs);

Effects: Equivalent to:

lhs.append(rhs);
return std::move(lhs);

except that both lhs and rhs are left in valid but unspecified states.

Effects: Equivalent to:

rhs.insert(0, lhs);
return std::move(rhs);

Effects: Equivalent to:

basic_string<charT, traits, Allocator> r = rhs;
r.insert(0, lhs);
return r;

Effects: Equivalent to:

basic_string<charT, traits, Allocator> r = rhs;
r.insert(r.begin(), lhs);
return r;

Effects: Equivalent to:

rhs.insert(rhs.begin(), lhs);
return std::move(rhs);

Effects: Equivalent to:

basic_string<charT, traits, Allocator> r = lhs;
r.push_back(rhs);
return r;

Effects: Equivalent to:

lhs.push_back(rhs);
return std::move(lhs);

Effects: Let op be the operator.

Equivalent to:

return basic_string_view<charT, traits>(lhs) op basic_string_view<charT, traits>(rhs);

Effects: Equivalent to lhs.swap(rhs).

Effects: Behaves as a formatted input function.

After constructing a sentry object, if the sentry converts to true, calls str.erase() and then extracts characters from is and appends them to str as if by calling str.append(1, c).

If is.width() is greater than zero, the maximum number n of characters appended is is.width(); otherwise n is str.max_­size().

Characters are extracted and appended until any of the following occurs:

• (1.1)
  n characters are stored;
• (1.2)
  end-of-file occurs on the input sequence;
• (1.3)
  isspace(c, is.getloc()) is true for the next available input character c.

After the last character (if any) is extracted, is.width(0) is called and the sentry object is destroyed.

If the function extracts no characters, it calls is.setstate(ios_­base​::​failbit), which may throw ios_­base​::​failure ([iostate.flags]).

Returns: is.

Effects: Equivalent to: return os << basic_­string_­view<charT, traits>(str);

Effects: Behaves as an unformatted input function, except that it does not affect the value returned by subsequent calls to basic_­istream<>​::​gcount().

After constructing a sentry object, if the sentry converts to true, calls str.erase() and then extracts characters from is and appends them to str as if by calling str.append(1, c) until any of the following occurs:

• (6.1)
  end-of-file occurs on the input sequence (in which case, the getline function calls is.setstate(​ios_­base​::​eofbit)).
• (6.2)
  traits​::​eq(c, delim) for the next available input character c (in which case, c is extracted but not appended) ([iostate.flags])
• (6.3)
  str.max_­size() characters are stored (in which case, the function calls is.setstate(ios_­base​::​failbit)) ([iostate.flags])

The conditions are tested in the order shown.

In any case, after the last character is extracted, the sentry object is destroyed.

If the function extracts no characters, it calls is.setstate(ios_­base​::​failbit) which may throw ios_­base​::​failure ([iostate.flags]).

Returns: is.

Returns: getline(is, str, is.widen('\n')).

Effects: Equivalent to:

auto it = remove(c.begin(), c.end(), value);
auto r = distance(it, c.end());
c.erase(it, c.end());
return r;

Effects: Equivalent to:

auto it = remove_if(c.begin(), c.end(), pred);
auto r = distance(it, c.end());
c.erase(it, c.end());
return r;