| Home | Libraries | People | FAQ | More

##### 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()`