std::allocator<T>:: allocate_at_least

Выделяет count * sizeof ( T ) байт неинициализированной памяти, где count - неопределённое целочисленное значение не меньшее n , путём вызова :: operator new (возможно с дополнительным аргументом std::align_val_t ), однако не определено, когда и как эта функция вызывается.

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

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

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

Параметры

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

std:: allocation_result < T * > { p, count } , где p указывает на первый элемент массива из count объектов типа T , элементы которого ещё не сконструированы.

Исключения

Выбрасывает std::bad_array_new_length если std:: numeric_limits < std:: size_t > :: max ( ) / sizeof ( T ) < n , или std::bad_alloc при неудачном выделении памяти.

Примечания

allocate_at_least в основном предоставляется для контейнеров с непрерывным хранением, таких как std::vector и std::basic_string , чтобы уменьшить количество перераспределений памяти за счёт соответствия их ёмкости фактически выделенному размеру, когда это возможно.

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

После вызова allocate_at_least и до конструирования элементов арифметика указателей T * корректно определена в пределах выделенного массива, но поведение не определено при обращении к элементам.

Пример

#include <memory>
#include <print>
int main()
{
    const std::size_t count{69};
    std::allocator<int> alloc;
    std::allocation_result res{alloc.allocate_at_least(count)};
    std::print("count: {}\n"
               "res.ptr: {}\n"
               "res.count: {}\n", count, res.ptr, res.count);
    /* construct, use, then destroy elements */
    alloc.deallocate(res.ptr, res.count);
}

count: 69
res.ptr: 0x555a486a0960
res.count: 96

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