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

This is an older version of Boost and was released in 2019. The current version is 1.89.0.

insert

insert

Prototype

template<
    class Container,
    class SinglePassRange
>
Container& insert(Container& target,
                  typename Container::iterator before,
                  const SinglePassRange& from);

// This overload is for target containers that do not require an insertion
// position e.g. set/map
template<
    class Container,
    class SinglePassRange
>
Container& insert(Container& target, const SinglePassRange& from);

Description

insert all of the elements in the range from before the before iterator into target.

Definition

Defined in the header file boost/range/algorithm_ext/insert.hpp

Requirements

SinglePassRange is a model of the Single Pass Range Concept.
Container supports insert at a specified position.
SinglePassRange's value type is convertible to Container's value type.

Complexity

Linear. distance(from) assignments are performed.