Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
Miscellaneous
complex
exception
functional
iterator
limits
locale
memory
new
numeric
stdexcept
typeinfo
utility
valarray
iterator
advance
back_inserter
distance
front_inserter
inserter
iterator
iterator_traits
iterator categories:
BidirectionalIterator
ForwardIterator
InputIterator
OutputIterator
RandomAccessIterator
predefined iterators:
back_insert_iterator
front_insert_iterator
insert_iterator
istreambuf_iterator
istream_iterator
ostreambuf_iterator
ostream_iterator
reverse_iterator
reverse_iterator
reverse_iterator::reverse_iterator
member functions:
base
operator*
operator+
operator++
operator+=
operator-
operator--
operator-=
operator->
operator[]


operator*

public member function
reference operator* () const;

Dereference iterator

Returns a reference to the element pointed by the iterator.

The iterator must point to some object (must not be null pointing) in order to be dereferenciable.

Parameters

none

Return value

A reference to the element pointed by the iterator.
reference is a member type defined as an alias of the base iterator's own reference type.

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
26
// reverse_iterator example
#include <iostream>
#include <iterator>
#include <vector>
using namespace std;
int main () {
  vector<int> myvector;
  for (int i=0; i<10; i++) myvector.push_back(i);
  typedef vector<int>::iterator iter_int;
                                                   // ? 9 8 7 6 5 4 3 2 1 0 ?
  iter_int begin (myvector.begin());               //   ^                    
                                                   //         ------>
  iter_int end (myvector.end());                   //                       ^
                                                   //                      
  reverse_iterator<iter_int> rev_end (begin);      // ^                    
                                                   //         <------     
  reverse_iterator<iter_int> rev_iterator (end);   //                     ^
  for ( ; rev_iterator < rev_end ; ++rev_iterator)
    cout << *rev_iterator << " ";
  cout << endl;
  return 0;
}


Output:

9 8 7 6 5 4 3 2 1 0

See also