string::insert (4 of 4 overloads)

Insert a range of characters.

template<
    class InputIt>
string&
insert(
    size_type pos,
    InputIt first,
    InputIt last);

Inserts characters from the range {first, last) before the character at index pos.

{first, last)is a valid range.

Strong guarantee.

All references, pointers, or iterators referring to contained elements are invalidated. Any past-the-end iterators are also invalidated.

Type	Description
`InputIt`	The type of the iterators.

InputItsatisfies InputIterator.

*this

Name	Description
`pos`	The index to insert at.
`first`	The beginning of the character range.
`last`	The end of the character range.

Type	Thrown On
boost::system::system_error	`size() + insert_count > max_size()`.
boost::system::system_error	`pos > size()`.