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 前)
[[nodiscard]] 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 可用于提供引用的局部性：若实现支持，则 allocator 会试图分配尽可能接近 hint 的新内存块。

è‹¥ T 为不完整类型则此函数的使用为谬构。

为了在常量表达式中使用此函数，必须在同一表达式的求值内解分配其所分配的存储。

(C++20 èµ·)

参数

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

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR	应用于	出版时的行为	正确行为
LWG 3190	C++11	allocate 可能分配大小错误的存储	替而抛出 bad_array_new_length

参阅

allocate [静态]

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