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

template< container-compatible-range<CharT> R >
constexpr std::basic_string& replace_with_range( const_iterator first,
                                                 const_iterator last,
                                                 R&& rg );

Replaces the characters in the range [first, last) with the characters from the range rg.

Equivalent to.

return replace(first,
               last,
               std::basic_string(
                   std::from_range,
                   std::forward<R>(rg),
                   get_allocator())
);

Parameters

Return value

*this.

Complexity

Linear in size of rg.

Exceptions

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

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

Notes

Example

See also