basic_static_string::insert (9 of 11 overloads)

Insert into the string.

Synopsis

constexpr basic_static_string::iterator
insert(
    basic_static_string::const_iterator pos,
    std::initializer_list< basic_static_string::value_type > ilist);

Description

Inserts characters from ilist before pos.

Precondition

pos shall be valid within {data(), data() + size()}

Exception Safety

Strong guarantee.

Remarks

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

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.
`ilist`	The initializer list from which to insert.

Exceptions

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