## NAME

ACE_Map_Reverse_Iterator - Reverse Iterator for the `ACE_Map_Manager`.

## SYNOPSIS

    #include <ace/Map_Manager.h>

    template<class EXT_ID, class INT_ID, class ACE_LOCK>
    class ACE_Map_Reverse_Iterator :
      public ACE_Map_Iterator_Base<EXT_ID, INT_ID, ACE_LOCK>
    {
      public:
        ACE_Map_Reverse_Iterator (
            ACE_Map_Manager <EXT_ID, INT_ID, ACE_LOCK> &mm,
            int pass_end = 0
            );
        int advance (void);
        void dump (void) const;
        ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator++ (
            void
            );
        ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> operator++ (
            int
            );
        ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator-- (
            void
            );
        ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> operator-- (
            int
            );
        ACE_ALLOC_HOOK_DECLARE;
    };

## DESCRIPTION

This class does not perform any internal locking of the `ACE_Map_Manager` it is iterating upon since locking is inherently inefficient and/or error-prone within an STL-style iterator. If you require locking, you can explicitly use an `ACE_Guard` or `ACE_Read_Guard` on the `ACE_Map_Manager`'s internal lock, which is accessible via its `mutex` method.

## Initialization method.

    ACE_Map_Reverse_Iterator (
        ACE_Map_Manager <EXT_ID, INT_ID, ACE_LOCK> &mm,
        int pass_end = 0
        );

## Iteration methods.

    int advance (void);

Move forward by one element in the set. Returns 0 when all the items in the set have been seen, else 1.

    void dump (void) const;

Dump the state of an object.

## STL styled iteration, compare, and reference functions.

    ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator++ (void);

Prefix reverse.

    ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> operator++ (int);

Postfix reverse.

    ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator-- (void);

Prefix advance.

    ACE_Map_Reverse_Iterator<EXT_ID, INT_ID, ACE_LOCK> operator-- (int);

Postfix advance.

    ACE_ALLOC_HOOK_DECLARE;

Declare the dynamic allocation hooks.

## AUTHOR

Doug Schmidt

## LIBRARY

ace