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)
6 [section:rotate rotate]
11 template<class ForwardRange>
12 ForwardRange& rotate(ForwardRange& rng,
13 typename range_iterator<ForwardRange>::type middle);
15 template<class ForwardRange>
16 const ForwardRange& rotate(const ForwardRange& rng,
17 typename range_iterator<const ForwardRange>::type middle);
22 `rotate` rotates the elements in a range. It exchanges the two ranges `[begin(rng), middle)` and `[middle, end(rng))`. Returns a reference to `rng`.
26 Defined in the header file `boost/range/algorithm/rotate.hpp`
28 [heading Requirements]
30 * `ForwardRange` is a model of the __forward_range__ Concept.
31 * `ForwardRange` is mutable.
33 [heading Precondition:]
35 * `[begin(rng), middle)` is a valid range.
36 * `[middle, end(rng))` is a valid range.
40 Linear. At most `distance(rng)` swaps are performed.