On this page
operator-(std::reverse_iterator)
|
(until C++11) | |
|
(since C++11) (until C++17) |
|
|
(since C++17) |
Returns the distance between two iterator adaptors.
Parameters
lhs, rhs | - | iterator adaptors to compute the difference of |
Return value
rhs.base() - lhs.base()
Example
#include <iostream>
#include <iterator>
#include <list>
#include <vector>
int main()
{
std::vector vec{0, 1, 2, 3};
std::reverse_iterator<std::vector<int>::iterator>
vec_ri1{std::reverse_iterator{vec.rbegin()}},
vec_ri2{std::reverse_iterator{vec.rend()}};
std::cout << (vec_ri2 - vec_ri1) << ' '; // 4
std::cout << (vec_ri1 - vec_ri2) << '\n'; // -4
std::list lst{5, 6, 7, 8};
std::reverse_iterator<std::list<int>::iterator>
lst_ri1{std::reverse_iterator{lst.rbegin()}},
lst_ri2{std::reverse_iterator{lst.rend()}};
// auto n = (lst_ri1 - lst_ri2); // error: the underlying iterators do not
// model the random access iterators
}
Output:
4 -4
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 280 | C++98 | subtrction between std::reverse_iterator with different underlying iterator types was not allowed |
allowed |
See also
advances or decrements the iterator (public member function) |
|
advances the iterator (function template) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/reverse_iterator/operator-