---
name: "ACE_Map_Iterator"
section: "3"
platform: "linux"
package: "libace-doc"
version: "5.0.7-4"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/ACE_Map_Iterator"
---

# ACE\_Map\_Iterator(3)

Forward iterator for the ACE\_Map\_Manager.

## NAME

ACE\_Map\_Iterator -  Forward 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_Iterator :
  public ACE_Map_Iterator_Base<EXT_ID, INT_ID, ACE_LOCK>
{
  public:
    ACE_Map_Iterator (
        ACE_Map_Manager <EXT_ID, INT_ID, ACE_LOCK> &mm,
        int pass_end = 0
        );
    int advance (void);
    void dump (void) const;
    ACE_Map_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator++ (void);
    ACE_Map_Iterator<EXT_ID, INT_ID, ACE_LOCK> operator++ (int);
    ACE_Map_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator-- (void);
    ACE_Map_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_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_Iterator<EXT_ID, INT_ID, ACE_LOCK> &operator++ (void);
```

Prefix advance.

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

Postfix advance.

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

Prefix reverse.

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

Postfix reverse.

```
ACE_ALLOC_HOOK_DECLARE;
```

Declare the dynamic allocation hooks.

## AUTHOR

Doug Schmidt

## LIBRARY

ace