std::allocator<T>::allocate
pointer allocate( size_type n, const void* hint = 0 );
|
(1) | (C++17前) |
T* allocate( std::size_t n, const void* hint );
|
(C++17起) (C++20移除) |
|
T* allocate( std::size_t n );
|
(2) | (C++17起) (C++20前) |
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 | - | 指向附近内存位置的指针 |
返回值
指向类型为
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 |
参阅
|
[static]
|
使用分配器分配未初始化的存储空间
(
std::allocator_traits<Alloc>
的公开静态成员函数)
|