string::insert (4 of 4 overloads)

Insert a range of characters.

Synopsis

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

Description

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

Precondition

{first, last)is a valid range.

Strong guarantee.

Remarks

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.

Constraints

InputItsatisfies InputIterator.

Return Value

*this

Parameters

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

Exceptions

Type	Thrown On
`std::length_error`	`size() + insert_count > max_size()`
`std::out_of_range`	`pos > size()`

Boost C++ Libraries