Namespaces
Variants
Views
Actions

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

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

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
 
 
 
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]