basic_static_string::insert (8 of 15 overloads)

Insert a character.

BOOST_STATIC_STRING_CPP14_CONSTEXPR iterator
insert(
    const_iterator pos,
    value_type ch);

Inserts the character ch before the character pointed by pos.

pos shall be vaild within [data(), data() + size()]

Strong guarantee.

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

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

Name	Description
`pos`	The index to insert at.
`ch`	The character to insert.

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