C++

Reference

<list>

list

public member function
<list>

std::list::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 list container.

Parameters

none

Return Value

The allocator.

Member type allocator_type is the type of the allocator used by the container, defined in list as an alias of its second 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
23
 
// list::get_allocator
#include <iostream>
#include <list>

int main ()
{
  std::list<int> mylist;
  int * p;

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

  // assign some values to array
  for (int i=0; i<5; ++i) p[i]=i;

  std::cout << "The allocated array contains:";
  for (int i=0; i<5; ++i) std::cout << ' ' << p[i];
  std::cout << '\n';

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

  return 0;
}
The example shows an elaborate way to allocate memory for an array of ints using the same allocator used by the container. Output:
The allocated array contains: 0 1 2 3 4


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

allocator
Default allocator (class template)