std::allocator::allocate

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Динамическое управление памятью

uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) voidify (C++20) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) Ограниченные алгоритмы неинициализированной памяти ranges::uninitialized_copy (C++20) ranges::uninitialized_fill (C++20) ranges::uninitialized_move (C++20) ranges::construct_at (C++20) ranges::destroy (C++20) ranges::destroy_n (C++20) ranges::destroy_at (C++20) ranges::uninitialized_copy_n (C++20) ranges::uninitialized_fill_n (C++20) ranges::uninitialized_move_n (C++20) ranges::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::uninitialized_default_construct_n (C++20)   ranges::uninitialized_value_construct_n (C++20) allocator allocator_traits (C++11) allocation_result (C++23) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20) scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) Ресурсы памяти pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17)   pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17) Поддержка сбора мусора declare_reachable (C++11)(до C++23) undeclare_reachable (C++11)(до C++23) declare_no_pointers (C++11)(до C++23) undeclare_no_pointers (C++11)(до C++23) pointer_safety (C++11)(до C++23) get_pointer_safety (C++11)(до C++23) raw_storage_iterator (до C++20*) get_temporary_buffer (до C++20*) return_temporary_buffer (до C++20*) Явное управление временем жизни start_lifetime_asstart_lifetime_as_array (C++23)(C++23)

unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (до C++17*) owner_less (C++11) owner_less<void> (C++17) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23) operator new operator new[] operator delete operator delete[] get_new_handler set_new_handler launder (C++17) bad_alloc bad_array_new_length nothrow_t align_val_t destroying_delete_t new_handler nothrow pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) Библиотека C malloc calloc realloc    aligned_alloc (C++17) free

 

std::allocator

Функции-элементы

allocator::allocator

allocator::~allocator

allocator::address (до C++20)

allocator::allocate

allocator::allocate_at_least (C++23)

allocator::deallocate

allocator::max_size (до C++20)

allocator::construct (до C++20)

allocator::destroy (до C++20)

Функции, не являющиеся элементами

operator==operator!= (до C++20)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

	(1)
pointer allocate( size_type n, const void* hint = 0 );			(до C++17)
T* allocate( std::size_t n, const void* hint );			(начиная с C++17) (устарело) (удалено в C++20)
		(2)
T* allocate( std::size_t n );				(начиная с C++17) (до C++20)
[[nodiscard]] constexpr T* allocate( std::size_t n );				(начиная с C++20)

Выделяет n * sizeof(T) байт неинициализированного хранилища, вызывая ::operator new(std::size_t) или ::operator new(std::size_t, std::align_val_t) (начиная с C++17), но не указано, когда и как вызывается эта функция. Указатель hint может использоваться для обеспечения локальности ссылки: распределитель, если поддерживается реализацией, попытается выделить новый блок памяти как можно ближе к hint.

Затем эта функция создаёт в хранилище массив типа T[n] и начинает его время жизни, но не начинает время жизни ни одного из его элементов.

Использование этой функции некорректно, если T является неполным типом.

Чтобы использовать эту функцию в константном выражении, выделенная память должна быть освобождена при вычислении того же выражения.

(начиная с C++20)

Параметры

n	—	количество объектов, для которых нужно выделить хранилище
hint	—	указатель на ближайшую ячейку памяти

Возвращаемое значение

Указатель на первый элемент массива n объектов типа T, элементы которого ещё не созданы.

Исключения

Генерирует std::bad_array_new_length, если std::numeric_limits<std::size_t>::max() / sizeof(T) < n.

(начиная с C++11)

Генерирует std::bad_alloc, если выделение не удалось.

Примечание

Формулировка "не указано, когда и как" позволяет объединять или оптимизировать выделение кучи, сделанное контейнерами стандартной библиотеки, даже несмотря на то, что такие оптимизации запрещены для прямых вызовов ::operator new. Например, это реализовано в libc++ ([1] и [2]).

После вызова allocate() и перед построением элементов арифметика указателя T* чётко определена в выделенном массиве, но поведение не определено при доступе к элементам.

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 578	C++98	hint должен был быть либо 0, либо указателем, ранее возвращённым из allocate() и ещё не переданным в deallocate()	не требуется
LWG 3190	C++11	allocate() может выделить хранилище неправильного размера	вместо этого генерирует std::bad_array_new_length

Смотрите также

allocate [static]

выделяет неинициализированное хранилище с помощью аллокатора (public static функция-элемент std::allocator_traits)