std::reverse_iterator

NAME

std::reverse_iterator -

SYNOPSIS


Inherits std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >< std::iterator_traits< _Iterator >::iterator_category, std::iterator_traits< _Iterator >::value_type, std::iterator_traits< _Iterator >::iterator_traits< _Iterator >::difference_type, std::iterator_traits< _Iterator >::iterator_traits< _Iterator >::pointer, std::iterator_traits< _Iterator >::iterator_traits< _Iterator >::reference >.

Detailed Description

template<typename _Iterator> class std::reverse_iterator< _Iterator >

      &*(reverse_iterator(i)) == &*(i - 1)

This mapping is dictated by the fact that while there is always a pointer past the end of an array, there might not be a valid pointer before the beginning of an array.' [24.4.1]/1,2
Reverse iterators can be tricky and surprising at first. Their semantics make sense, however, and the trickiness is a side effect of the requirement that the iterators must be safe.
Definition at line 94 of file stl_iterator.h.

Public Types

typedef iterator_traits< _Iterator >::difference_type difference_type
typedef _Category iterator_category
typedef _Iterator iterator_type
typedef iterator_traits< _Iterator >::pointer pointer
typedef iterator_traits< _Iterator >::reference reference
typedef _Tp value_type

Public Member Functions

iterator_type base () const
reference operator * () const
reverse_iterator operator+ (difference_type __n) const
reverse_iterator operator++ (int)
reverse_iterator & operator++ ()
reverse_iterator & operator+= (difference_type __n)
reverse_iterator operator- (difference_type __n) const
reverse_iterator operator-- (int)
reverse_iterator & operator-- ()
reverse_iterator & operator-= (difference_type __n)
pointer operator-> () const
reference operator[] (difference_type __n) const
template<typename _Iter> reverse_iterator (const reverse_iterator< _Iter > &__x)
reverse_iterator (const reverse_iterator &__x)
reverse_iterator (iterator_type __x)
reverse_iterator ()

Protected Attributes

_Iterator current

Member Typedef Documentation

template<typename _Iterator> typedef iterator_traits<_Iterator>::difference_type std::reverse_iterator< _Iterator >::difference_type

Distance between iterators is represented as this type.
Reimplemented from std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >.
Definition at line 107 of file stl_iterator.h.

template<typename _Category, typename _Tp, typename _Distance = ptrdiff_t, typename _Pointer = _Tp*, typename _Reference = _Tp&> typedef _Category std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >::iterator_category [inherited]

One of the tag types.
Definition at line 107 of file stl_iterator_base_types.h.

template<typename _Iterator> typedef iterator_traits<_Iterator>::pointer std::reverse_iterator< _Iterator >::pointer

This type represents a pointer-to-value_type.
Reimplemented from std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >.
Definition at line 109 of file stl_iterator.h.

template<typename _Iterator> typedef iterator_traits<_Iterator>::reference std::reverse_iterator< _Iterator >::reference

This type represents a reference-to-value_type.
Reimplemented from std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >.
Definition at line 108 of file stl_iterator.h.

template<typename _Category, typename _Tp, typename _Distance = ptrdiff_t, typename _Pointer = _Tp*, typename _Reference = _Tp&> typedef _Tp std::iterator< _Category, _Tp, _Distance, _Pointer, _Reference >::value_type [inherited]

The type 'pointed to' by the iterator.
Reimplemented in __gnu_cxx::sequence_buffer< _Sequence, _Buf_sz >.
Definition at line 109 of file stl_iterator_base_types.h.

Constructor & Destructor Documentation

template<typename _Iterator> std::reverse_iterator< _Iterator >::reverse_iterator () [inline]

The default constructor default-initializes member current. If it is a pointer, that means it is zero-initialized.
Definition at line 118 of file stl_iterator.h.

template<typename _Iterator> std::reverse_iterator< _Iterator >::reverse_iterator (iterator_type __x) [inline, explicit]

This iterator will move in the opposite direction that x does.
Definition at line 124 of file stl_iterator.h.

template<typename _Iterator> std::reverse_iterator< _Iterator >::reverse_iterator (const reverse_iterator< _Iterator > & __x) [inline]

The copy constructor is normal.
Definition at line 129 of file stl_iterator.h.

template<typename _Iterator> template<typename _Iter> std::reverse_iterator< _Iterator >::reverse_iterator (const reverse_iterator< _Iter > & __x) [inline]

A reverse_iterator across other types can be copied in the normal fashion.
Definition at line 137 of file stl_iterator.h.

Member Function Documentation

template<typename _Iterator> iterator_type std::reverse_iterator< _Iterator >::base () const [inline]

Returns:
current, the iterator used for underlying work.
Definition at line 144 of file stl_iterator.h.
Referenced by std::operator+(), std::operator-(), and std::operator==().

template<typename _Iterator> reference std::reverse_iterator< _Iterator >::operator * () const [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 153 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator std::reverse_iterator< _Iterator >::operator+ (difference_type __n) const [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 224 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator std::reverse_iterator< _Iterator >::operator++ (int) [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 186 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator& std::reverse_iterator< _Iterator >::operator++ () [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 174 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator& std::reverse_iterator< _Iterator >::operator+= (difference_type __n) [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 233 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator std::reverse_iterator< _Iterator >::operator- (difference_type __n) const [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 245 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator std::reverse_iterator< _Iterator >::operator-- (int) [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 211 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator& std::reverse_iterator< _Iterator >::operator-- () [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 199 of file stl_iterator.h.

template<typename _Iterator> reverse_iterator& std::reverse_iterator< _Iterator >::operator-= (difference_type __n) [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 254 of file stl_iterator.h.

template<typename _Iterator> pointer std::reverse_iterator< _Iterator >::operator-> () const [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 165 of file stl_iterator.h.
References std::operator *().

template<typename _Iterator> reference std::reverse_iterator< _Iterator >::operator[] (difference_type __n) const [inline]

Returns:
TODO
Todo
Doc me! See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more.
Definition at line 266 of file stl_iterator.h.

Author

Generated automatically by Doxygen for libstdc++ from the source code.