std::allocation_result

来自cppreference.com
< cpp‎ | memory
 
 
工具库
语言支持
类型支持(基本类型、RTTI)
库功能特性测试宏 (C++20)
动态内存管理
程序工具
协程支持 (C++20)
变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受约束的未初始化内存算法
分配器
allocation_result
(C++23)
垃圾收集器支持
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)



 
在标头 <memory> 定义
template< class Pointer, class SizeType = std::size_t >
struct allocation_result;
(C++23 起)

allocation_result 特化由适合的分配器 (Allocator) 类型的 allocate_at_least 成员函数(例如 std::allocator::allocate_at_least)及 std::allocator_traits::allocate_at_least 返回。

allocation_result 的每个特化均无基类或除 ptrcount 之外的声明成员,从而它适合聚合初始化结构化绑定

模板形参

Pointer - 常为 std::allocator_traits<Alloc>::pointer,其中 Alloc分配器 (Allocator) 类型
SizeType - 常为 std::allocator_traits<Alloc>::size_type,其中 Alloc分配器 (Allocator) 类型

数据成员

成员名字 定义
ptr
Pointer 类型的指针,常用于 allocate_at_least 所分配的存储中首元素的地址
(公开成员对象)
count
SizeType 类型的值,常用于 allocate_at_least 所分配的存储中的实际元素数
(公开成员对象)

注解

PointerSizeType 默认分别为指向对象类型的指针与 std::make_unsigned_t<std::ptrdiff_t>(几乎总是与 std::size_t 为同一类型)。

功能特性测试 标准 功能特性
__cpp_lib_allocate_at_least 202302L (C++23) 分配器接口中的大小反馈

示例

参阅

分配与请求的大小至少一样大的未初始化存储
(std::allocator<T> 的公开成员函数)
[静态] (C++23)
经由分配器分配至少与请求的大小一样大的存储
(std::allocator_traits<Alloc> 的公开静态成员函数)