| Home | Libraries | People | FAQ | More

##### basic_static_string::insert (7 of 11 overloads)

Insert into the string.

###### Synopsis

    constexpr basic_static_string::iterator
    insert(
        basic_static_string::const_iterator pos,
        basic_static_string::size_type count,
        basic_static_string::value_type ch);

###### Description

Inserts `count` copies of `ch` before the character pointed by `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.
`count` | The number of characters to insert.
`ch` | The character to insert.

###### Exceptions

Type | Thrown On
--- | ---
`std::length_error` | `size() + count > max_size()`