std::allocator
Определено в заголовке <memory> | ||
|---|---|---|
template< class T > struct allocator; | (1) | |
template<> struct allocator<void>; | (2) | (устарело в C++17) (удалено в C++20) |
Шаблон класса std::allocator является по умолчанию Allocator, используемым всеми контейнерами стандартной библиотеки, если не указан пользовательский аллокатор. Аллокатор по умолчанию бессостоятельный, то есть все экземпляры данного аллокатора взаимозаменяемы, сравниваются как равные и могут освобождать память, выделенную любым другим экземпляром того же типа аллокатора.
| Явная специализация для void отсутствует типы-члены | (до C++20) |
| Аллокатор по умолчанию удовлетворяет требованиям полноты аллокатора. | (с C++17) |
Типы-члены
| Тип | Определение |
|---|---|
value_type | T |
pointer (устарело в C++17)(удалено в C++20) | T* |
const_pointer (устарело в C++17)(удалено в C++20) | const T* |
reference (устарело в C++17)(удалено в C++20) | T& |
const_reference (устарело в C++17)(удалено в C++20) | const T& |
size_type | std::size_t |
difference_type | std::ptrdiff_t |
propagate_on_container_move_assignment (C++11) | std::true_type |
rebind (устарело в C++17)(удалено в C++20) | template< class U > struct rebind { typedef allocator<U> other; }; |
is_always_equal (C++11)(устарело в C++23)(удалено в C++26) | std::true_type |
Функции-члены
| создаёт новый экземпляр аллокатора (публичная функция-член) |
|
| уничтожает экземпляр аллокатора (публичная функция-член) |
|
|
(до C++20) | получает адрес объекта, даже если перегружен оператор & (публичная функция-член) |
| выделяет неинициализированное хранилище (публичная функция-член) |
|
|
(C++23) | выделяет неинициализированное хранилище, по крайней мере, такого размера, как указанный размер (публичная функция-член) |
| освобождает хранилище (публичная функция-член) |
|
|
(до C++20) | возвращает наибольший поддерживаемый размер выделения (публичная функция-член) |
|
(до C++20) | строит объект в выделенном хранилище (публичная функция-член) |
|
(до C++20) | уничтожает объект в выделенном хранилище (публичная функция-член) |
Внешние функции
|
(удалено в C++20) | сравнивает два экземпляра аллокатора (публичная функция-член) |
Примечания
Шаблон класса-член rebind предоставляет способ получения аллокатора для другого типа. Например, std::list<T, A> выделяет узлы некоторого внутреннего типа Node<T>, используя аллокатор A::rebind<Node<T>>::other(до C++11)std::allocator_traits<A>::rebind_alloc<Node<T>>, который реализован в терминах A::rebind<Node<T>>::other если A является std::allocator(с C++11).
Тип-член is_always_equal устарел через LWG issue 3170, потому что он заставляет пользовательские аллокаторы, производные от std::allocator обрабатываться как всегда равные по умолчанию. std::allocator_traits<std::allocator<T>>::is_always_equal не устарела и её константа-член value равна true для любого T.
Пример
#include <iostream>
#include <memory>
#include <string>
int main()
{
// default allocator for ints
std::allocator<int> alloc1;
// demonstrating the few directly usable members
static_assert(std::is_same_v<int, decltype(alloc1)::value_type>);
int* p1 = alloc1.allocate(1); // space for one int
alloc1.deallocate(p1, 1); // and it is gone
// Even those can be used through traits though, so no need
using traits_t1 = std::allocator_traits<decltype(alloc1)>; // The matching trait
p1 = traits_t1::allocate(alloc1, 1);
traits_t1::construct(alloc1, p1, 7); // construct the int
std::cout << *p1 << '\n';
traits_t1::deallocate(alloc1, p1, 1); // deallocate space for one int
// default allocator for strings
std::allocator<std::string> alloc2;
// matching traits
using traits_t2 = std::allocator_traits<decltype(alloc2)>;
// Rebinding the allocator using the trait for strings gets the same type
traits_t2::rebind_alloc<std::string> alloc_ = alloc2;
std::string* p2 = traits_t2::allocate(alloc2, 2); // space for 2 strings
traits_t2::construct(alloc2, p2, "foo");
traits_t2::construct(alloc2, p2 + 1, "bar");
std::cout << p2[0] << ' ' << p2[1] << '\n';
traits_t2::destroy(alloc2, p2 + 1);
traits_t2::destroy(alloc2, p2);
traits_t2::deallocate(alloc2, p2, 2);
}Вывод:
7 foo bar
Отчёты об ошибках
Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применяется к | Поведение, как опубликовано | Правильное поведение |
|---|---|---|---|
| LWG 2103 | C++11 | избыточное сравнение между allocator могло потребоваться |
propagate_on_container_move_assignment предоставлено |
| LWG 2108 | C++11 | не было способа показать, что allocator бессостоятельный |
is_always_equal предоставлено |
См. также
|
(C++11) | предоставляет информацию о типах аллокаторов (шаблон класса) |
|
(C++11) | реализует аллокатор нескольких уровней для контейнеров нескольких уровней (шаблон класса) |
|
(C++11) | проверяет, поддерживает ли указанный тип создание с помощью аллокатора (шаблон класса) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/memory/allocator