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.
If pos is not a valid iterator on *this, the behavior is undefined.
|pos||-||iterator before which the characters will be inserted|
|rg||-||a container compatible range|
 Return value
An iterator which refers to the first inserted character, or pos if no characters were inserted because rg was empty.
Linear in size of rg.
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).
||202202L||(C++23)||member functions that accept container compatible range|
|This section is incomplete|
Reason: no example
 See also
| inserts characters |
(public member function)