basic_string&
append(const basic_string& str);
Effects: Calls
append(str.data(), str.size()). basic_string&
append(const basic_string& str, size_type pos, size_type n = npos);
Throws:
out_of_range
if
pos > str.size(). Effects:
Determines the effective length
rlen
of the string to append as the smaller of
n and
str.size() - pos and calls
append(str.data() + pos, rlen). basic_string& append(basic_string_view<charT, traits> sv);
Effects:
Equivalent to: return append(sv.data(), sv.size());
template<class T>
basic_string& append(const T& t, size_type pos, size_type n = npos);
Throws:
out_of_range
if
pos > sv.size(). Effects:
Creates a variable,
sv, as if by
basic_string_view<charT, traits> sv = t. Determines the effective length
rlen of the string to append
as the smaller of
n and
sv.size() - pos
and calls
append(sv.data() + pos, rlen).Remarks:
This function shall not participate in overload resolution
unless
is_convertible_v<const T&, basic_string_view<charT, traits>>
is
true and
is_convertible_v<const T&, const charT*> is
false. basic_string&
append(const charT* s, size_type n);
Requires: s points to an array of at least
n elements
of
charT. Throws: length_error if
size() + n > max_size(). Effects: The function replaces the string controlled by
*this
with a string of length
size() + n whose first
size()
elements are a copy of the original string controlled by
*this
and whose remaining elements are a copy of the initial
n elements
of
s. basic_string& append(const charT* s);
Requires: s points to an array of at least
traits::length(s) + 1
elements of
charT. Effects: Calls
append(s, traits::length(s)). basic_string& append(size_type n, charT c);
Effects: Equivalent to
append(basic_string(n, c)). template<class InputIterator>
basic_string& append(InputIterator first, InputIterator last);
Requires:[first, last) is a valid range
. Effects: Equivalent to
append(basic_string(first, last, get_allocator())). basic_string& append(initializer_list<charT> il);
Effects: Calls
append(il.begin(), il.size()). void push_back(charT c);
Effects:
Equivalent to
append(static_cast<size_type>(1), c).