std::aligned_alloc
来自cppreference.com
在标头 <cstdlib> 定义 | ||
void* aligned_alloc(std::size_t alignment, std::size_t size ); | (C++17 起) | |
分配 size 字节的未初始化存储，由 alignment 指定其对齐（在目标区域中隐式创建对象）。size 参数必须是 alignment 的整数倍。
要求下列函数是线程安全的：
new运算符和delete运算符的库版本- 全局
new运算符和delete运算符的用户替换版本 - std::calloc、std::malloc、std::realloc、std::aligned_alloc、std::free
对这些分配或解分配特定存储单元的函数调用以单独全序出现，而并且在此顺序中，每个解分配调用先发生于下个分配（如果存在）。
目录 |
[编辑] 参数
| alignment | - | 指定对齐。必须是实现支持的合法对齐。 |
| size | - | 分配的字节数。alignment 的整数倍。 |
[编辑]返回值
成功时，返回指向新分配内存起始的指针。为避免内存泄漏，返回的指针必须由 std::free 或 std::realloc 解分配。
失败时，返回空指针。
[编辑]注解
传递不是 alignment 整数倍的 size 或不受实现支持或非法的 alignment 导致函数失败并返回空指针（C11 刚发布时，曾指定此情况为未定义行为，这为 DR 460 所纠正）。
作为“实现支持”要求的例子，POSIX 函数 posix_memalign 接受任何是二的幂且为 sizeof(void*) 倍数的 alignment，而基于 POSIX 的 aligned_alloc 实现继承此要求。
基础对齐始终得到支持。若 alignment 是二的幂且不大于 alignof(std::max_align_t)，则 aligned_alloc 可以简单地调用 std::malloc。
常规的 std::malloc 分配适用于具有任何基础对齐的对象类型的内存。此函数适用于过对齐分配，例如对 SSE、缓存线或 VM 页边界。
Microsoft C 运行时库不支持此函数，因为其 std::free 的实现无法处理任意种类的对齐分配。 MS CRT 提供 _aligned_malloc 作为替代（其结果应以 _aligned_free 释放）。
[编辑]示例
运行此代码
#include <cstdio>#include <cstdlib> int main(){int* p1 =static_cast<int*>(std::malloc(10*sizeof *p1));std::printf("默认对齐地址: %p\n", static_cast<void*>(p1));std::free(p1); int* p2 =static_cast<int*>(std::aligned_alloc(1024, 10*sizeof *p2));std::printf("1024 字节对齐地址: %p\n", static_cast<void*>(p2));std::free(p2);}
可能的输出：
默认对齐地址: 0x2221c20 1024 字节对齐地址: 0x2222400
[编辑]参阅
(C++11 起)(C++23 弃用) | 定义适于用作给定大小的类型的未初始化存储的类型 (类模板) |
aligned_alloc 的 C 文档 | |
