reverse_iterator::operator-
Subtracts an offset from a reverse_iterator and returns a reverse_iterator addressing the element at the offset position.
reverse_iterator<RandomIterator> operator-(
difference_type _Off
) const;
Parameters
- _Off
The offset to be subtracted from the reverse_iterator.
Return Value
A reverse_iterator addressing the offset element.
Remarks
This member function may only be used if the reverse_iterator satisfies the requirements for a random-access iterator.
Example
// reverse_iterator_op_sub.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main( )
{
using namespace std;
int i;
vector<int> vec;
for ( i = 1 ; i < 6 ; ++i )
{
vec.push_back ( 3 * i );
}
vector <int>::iterator vIter;
cout << "The vector vec is: ( ";
for ( vIter = vec.begin( ) ; vIter != vec.end( ); vIter++)
cout << *vIter << " ";
cout << ")." << endl;
vector <int>::reverse_iterator rvIter;
cout << "The vector vec reversed is: ( ";
for ( rvIter = vec.rbegin( ) ; rvIter != vec.rend( ); rvIter++)
cout << *rvIter << " ";
cout << ")." << endl;
// Initializing reverse_iterators to the first element
vector <int>::reverse_iterator rVPOS1 = vec.rend ( ) - 1;
cout << "The iterator rVPOS1 initially points to the last "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
vector <int>::reverse_iterator rVPOS2 =rVPOS1 - 2; // offset subtracted
cout << "After the -2 offset, the iterator rVPOS2 points\n"
<< " to the 2nd element from the last in the reversed sequence: "
<< *rVPOS2 << "." << endl;
}
The vector vec is: ( 3 6 9 12 15 ). The vector vec reversed is: ( 15 12 9 6 3 ). The iterator rVPOS1 initially points to the last element in the reversed sequence: 3. After the -2 offset, the iterator rVPOS2 points to the 2nd element from the last in the reversed sequence: 9.
Requirements
Header: <iterator>
Namespace: std