1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
|
[/
Copyright 2010 Neil Groves
Distributed under the Boost Software License, Version 1.0.
(See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
/]
[section:insert insert]
[heading 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);
``
[heading Description]
`insert` all of the elements in the range `from` before the `before` iterator into `target`.
[heading Definition]
Defined in the header file `boost/range/algorithm_ext/insert.hpp`
[heading 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.
[heading Complexity]
Linear. `distance(from)` assignments are performed.
[endsect]
|