Apache C++ Standard Library Reference Guide

## <map>

Library: Containers

    Header

- Local Index
- Summary
- Synopsis
- See Also
- Standards Conformance

### Local Index

No Entries

### Summary

The header `<map>` is part of the Containers library of the C++ Standard library. It defines the associative container class templates map and multimap, a set of relational operators that C++ programs may use to perform equality and inequality tests on specializations of map and multimap, and specializations of the `swap()` algorithm for map and multimap.

### Synopsis

    namespace std {
      template <class Key, class T, class Compare = less<Key>,
                class Allocator = allocator<pair<const Key, T> > >
      class map;
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator==(const map<Key, T, Compare, Allocator>&,
                      const map<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator<(const map<Key, T, Compare, Allocator>&,
                     const map<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator!=(const map<Key, T, Compare, Allocator>&,
                      const map<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator>(const map<Key, T, Compare, Allocator>&,
                     const map<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator>=(const map<Key, T, Compare, Allocator>&,
                      const map<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator<=(const map<Key, T, Compare, Allocator>&,
                      const map<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      void swap(map<Key, T, Compare, Allocator>&,
                map<Key, T, Compare, Allocator>&);

      template <class Key, class T, class Compare = less<Key>,
                class Allocator = allocator<pair<const Key, T> > >
      class multimap;
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator==(const multimap<Key, T, Compare, Allocator>&,
                      const multimap<Key, T, Compare,
                                     Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator<(const multimap<Key, T, Compare, Allocator>&,
                     const multimap<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator!=(const multimap<Key, T, Compare, Allocator>&,
                      const multimap<Key, T, Compare,
                                     Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator>(const multimap<Key, T, Compare, Allocator>&,
                     const multimap<Key, T, Compare, Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator>=(const multimap<Key, T, Compare, Allocator>&,
                      const multimap<Key, T, Compare,
                                     Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      bool operator<=(const multimap<Key, T, Compare, Allocator>&,
                      const multimap<Key, T, Compare,
                                     Allocator>&);
      template <class Key, class T, class Compare,
                class Allocator>
      void swap(multimap<Key, T, Compare, Allocator>&,
                multimap<Key, T, Compare, Allocator>&);
    }

### See Also

multimap, Containers, Associative Containers

### Standards Conformance

ISO/IEC 14882:1998 -- International Standard for Information Systems --Programming Language C++, Section 23.3