Namespaces
Variants
Views
Actions

std::basic_string<CharT,Traits,Allocator>::append_range

From cppreference.com
< cpp‎ | string‎ | basic string
Revision as of 14:29, 9 June 2023 by Andreas Krug (Talk | contribs)

 
 
 
std::basic_string
 
template< container-compatible-range<CharT> R >
constexpr std::basic_string& append_range(R&& rg);
(1) (since C++23)

Appends all characters from the range rg.

Equivalent to

return append(std::basic_string( std::from_range, std​::​forward<R>(rg), get_allocator()));

Contents

Parameters

rg - a container-compatible-range

Return value

*this

Complexity

Linear in size of rg.

Exceptions

Throws std::length_error if the resultant string size would exceed max_size().

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

Example

See also

appends characters to the end
(public member function) [edit]