Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
basic_static_string::insert (9 of 15 overloads)

Insert characters.

Synopsis
BOOST_STATIC_STRING_CPP14_CONSTEXPR iterator
insert(
    const_iterator pos,
    size_type count,
    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()


PrevUpHomeNext