std::allocator<T>:: allocate

	(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 前)
constexpr T * allocate ( std:: size_t n ) ;				(C++20 起)

通过调用 :: operator new ( std:: size_t ) 或 :: operator new ( std:: size_t , std:: align_val_t ) (C++17 起) 分配 n * sizeof ( T ) 字节的未初始化存储空间，但未规定此函数的调用时间和方式。指针 hint 可用于提供引用局部性：若实现支持，分配器将尝试在尽可能接近 hint 的位置分配新内存块。

随后，该函数在存储中创建一个类型为 T[n] 的数组并启动其生存期，但不会启动其任何元素的生存期。

若 T 为 不完整类型 ，则此函数的使用属于病式用法。

为了在常量表达式中使用此函数，分配的内存必须在同一表达式的求值过程中被释放。

(since C++20)

目录 1 参数 2 返回值 3 异常 4 备注 5 缺陷报告 6 参见

参数

n	-	要分配存储空间的对象数量
hint	-	指向附近内存位置的指针

返回值

指向类型为 T 的 n 个对象数组的首元素指针，该数组的元素尚未被构造。

异常

若 std:: numeric_limits < std:: size_t > :: max ( ) / sizeof ( T ) < n 则抛出 std::bad_array_new_length 。

(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]

使用分配器分配未初始化的存储空间 ( std::allocator_traits<Alloc> 的公开静态成员函数)