Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext
basic_static_string::insert (9 of 11 overloads)

Insert into the string.

Synopsis
constexpr iterator
insert(
    const_iterator pos,
    std::initializer_list< value_type > ilist);
Description

Inserts characters from ilist before pos.

Precondition

posshall 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.

ilist

The initializer list from which to insert.

Exceptions

Type

Thrown On

std::length_error

size() + ilist.size() > max_size()


PrevUpHomeNext