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

template< container-compatible-range<CharT> R >
constexpr iterator insert_range( const_iterator pos, R&& rg );

Inserts characters from the range rg before the element (if any) pointed by pos.

Equivalent to.

return insert(pos - begin(),
    std::basic_string(
        std::from_range,
        std​::​forward<R>(rg),
        get_allocator())
);

If pos is not a valid iterator on *this, the behavior is undefined.

Parameters

Return value

An iterator which refers to the first inserted character, or pos if no characters were inserted because rg was empty.

Complexity

Linear in size of rg.

Exceptions

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

If std::allocator_traits<Allocator>::allocate throws an exception, it is rethrown.

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

Notes

Example

See also