[ceph.git] / ceph / src / boost / libs / range / doc / reference / algorithm_ext / push_back.qbk

[/
    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:push_back push_back]

[heading Prototype]

``
template<
    class Container,
    class SinglePassRange
    >
Container& push_back(Container& target,
                     const SinglePassRange& from);
``

[heading Description]

`push_back` all of the elements in the range `from` to the back of the container `target`.

[heading Definition]

Defined in the header file `boost/range/algorithm_ext/push_back.hpp`

[heading Requirements]

# `SinglePassRange` is a model of the __single_pass_range__ Concept.
# `Container` supports insert at `end()`.
# `SinglePassRange`'s value type is convertible to `Container`'s value type.

[heading Complexity]

Linear. `distance(from)` assignments are performed.

[endsect]
Commit	Line	Data
7c673cae FG	1	[/
	2	Copyright 2010 Neil Groves
	3	Distributed under the Boost Software License, Version 1.0.
	4	(See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
	5	/]
	6	[section:push_back push_back]
	7
	8	[heading Prototype]
	9
	10	``
	11	template<
	12	class Container,
	13	class SinglePassRange
	14	>
	15	Container& push_back(Container& target,
	16	const SinglePassRange& from);
	17	``
	18
	19	[heading Description]
	20
	21	`push_back` all of the elements in the range `from` to the back of the container `target`.
	22
	23	[heading Definition]
	24
	25	Defined in the header file `boost/range/algorithm_ext/push_back.hpp`
	26
	27	[heading Requirements]
	28
	29	# `SinglePassRange` is a model of the __single_pass_range__ Concept.
	30	# `Container` supports insert at `end()`.
	31	# `SinglePassRange`'s value type is convertible to `Container`'s value type.
	32
	33	[heading Complexity]
	34
	35	Linear. `distance(from)` assignments are performed.
	36
	37	[endsect]