string::insert (3 of 4 overloads)

Insert a character.

Synopsis

string&
insert(
    size_type pos,
    char ch);

Description

Inserts the character ch before the character at index pos.

Strong guarantee.

Remarks

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

Return Value

*this

Parameters

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

Exceptions

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

Boost C++ Libraries