basic_static_string::insert (10 of 15 overloads)

Insert a range of characters.

Synopsis

template<
    typename InputIterator>
BOOST_STATIC_STRING_CPP14_CONSTEXPR std::enable_if< detail::is_input_iterator< InputIterator >::value &&!detail::is_forward_iterator< InputIterator >::value, iterator >::type
insert(
    const_iterator pos,
    InputIterator first,
    InputIterator last);

Description

Inserts characters from the range [first, last) before the character pointed to by pos.

Precondition

pos shall be valid within [data(), data() + size()], [first, last) shall be a valid range

Exception Safety

Strong guarantee.

Remarks

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

Template Parameters

Type	Description
`InputIterator`	The type of the iterators.

Constraints

InputIterator satisfies InputIterator and does not satisfy ForwardIterator.

Return Value

An iterator which refers to the first inserted character or pos if no characters were inserted

Parameters

Name	Description
`pos`	The position to insert at.
`first`	An iterator representing the first character to insert.
`last`	An iterator representing one past the last character to insert.

Exceptions

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