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