public member function
<map>

std::multimap::get_allocator

allocator_type get_allocator() const;
allocator_type get_allocator() const noexcept;
Get allocator
Returns a copy of the allocator object associated with the multimap.

Parameters

none

Return Value

The allocator.

Member type allocator_type is the type of the allocator used by the container, defined in multimap as an alias of its fourth template parameter (Alloc).

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// map::get_allocator
#include <iostream>
#include <map>

int main ()
{
  int psize;
  std::multimap<char,int> mymm;
  std::pair<const char,int>* p;

  // allocate an array of 5 elements using mymm's allocator:
  p=mymm.get_allocator().allocate(5);

  // assign some values to array
  psize = sizeof(std::multimap<char,int>::value_type)*5;

  std::cout << "The allocated array has a size of " << psize << " bytes.\n";

  mymm.get_allocator().deallocate(p,5);

  return 0;
}
The example shows an elaborate way to allocate memory for an array of pairs using the same allocator used by the container.
A possible output is:
The allocated array has a size of 40 bytes.


Complexity

Constant.

Iterator validity

No changes.

Data races

The container is accessed.
No contained elements are accessed: concurrently accessing or modifying them is safe.

Exception safety

No-throw guarantee: this member function never throws exceptions.
Copying any instantiation of the default allocator is also guaranteed to never throw.

See also