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

   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]