|
rotate_copy
function template
<algorithm>
template <class ForwardIterator, class OutputIterator>
OutputIterator rotate_copy ( ForwardIterator first, ForwardIterator middle,
ForwardIterator last, OutputIterator result );
Copy rotated range
Copies the values of the elements in the range [first,last) to the range positions beginning at result, but rotating the order of the elements in such a way that the element pointed by middle becomes the first element in the resulting range.
The behavior of this function template is equivalent to:
1
2
3
4
5
6
7
|
template <class ForwardIterator, class OutputIterator>
OutputIterator rotate_copy ( ForwardIterator first, ForwardIterator middle,
ForwardIterator last, OutputIterator result )
{
result=copy (middle,last,result);
return copy (first,middle,result);
}
|
Parameters
- first, last
- Forward iterators to the initial and final positions of the range to be copied rotated. The range used is [first,last), which contains all the elements between first and last, including the element pointed by first but not the element pointed by last.
Notice that in this function, these are not consecutive parameters, but the first and third ones.
- middle
- Forward iterator pointing to the element within the range [first,last) that is copied as the first element in the resulting range.
Return value
An output iterator pointing to the end of the copied range.
Example
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
|
// rotate_copy algorithm example
#include <iostream>
#include <algorithm>
#include <vector>
using namespace std;
int main () {
int myints[] = {10,20,30,40,50,60,70};
vector<int> myvector;
vector<int>::iterator it;
myvector.resize(7);
rotate_copy(myints,myints+3,myints+7,myvector.begin());
// print out content:
cout << "myvector contains:";
for (it=myvector.begin(); it!=myvector.end(); ++it)
cout << " " << *it;
cout << endl;
return 0;
}
|
Output:
myvector contains: 40 50 60 70 10 20 30
|
Complexity
Linear: Performs as many assignment operations as the length of range [first,last).
See also
| rotate | Rotate elements in range (function template) |
| random_shuffle | Rearrange elements in range randomly (function template) |
| copy | Copy range of elements (function template) |
|