std::aligned_alloc
来自cppreference.com
| 定义于头文件 <cstdlib>
|
||
| void* aligned_alloc( std::size_t alignment, std::size_t size ); |
(C++17 起) | |
分配 size 字节的未初始化存储，由 alignment 指定其对齐。 size 参数必须是 alignment 的整数倍。
|
要求下列函数是线程安全的：
对这些分配或解分配特定存储单元的函数调用以单独全序出现，并且在此顺序中，每个解分配调用先发生于下个分配（若存在）。 |
(C++11 起) |
参数
| alignment | - | 指定对齐。必须是实现支持的合法对齐。 |
| size | - | 分配的字节数。 alignment 的整数倍。
|
返回值
成功时，返回指向新分配内存起始的指针。为避免内存泄漏，返回的指针必须由 std::free 或 std::realloc 解分配。
失败时，返回空指针。
注意
传递不是 alignment 整数倍的 size 或不受实现支持或非法的 alignment 导致函数失败并返回空指针（ C11 刚发布时，曾指定此情况为未定义行为，这为 DR 460 所纠正）。
作为“实现支持”要求的例子， POSIX 函数 posix_memalign 接受任何是二的幂且为 sizeof(void*) 倍数的 alignment ，而基于 POSIX 的 aligned_alloc 实现继承此要求。
常规的 std::malloc 分配适用于任何对象的大小的内存（实际上，意味着内存对齐到 alignof(std::max_align_t) ）。此函数适用于过对齐分配，例如对 SSE 、缓存线或 VM 页边界。
示例
运行此代码
#include <cstdio> #include <cstdlib> int main() { int* p1 = static_cast<int*>(std::malloc(10*sizeof *p1)); std::printf("default-aligned address: %p\n", static_cast<void*>(p1)); std::free(p1); int* p2 = static_cast<int*>(std::aligned_alloc(1024, 10*sizeof *p2)); std::printf("1024-byte aligned address: %p\n", static_cast<void*>(p2)); std::free(p2); }
可能的输出：
default-aligned address: 0x2221c20 1024-byte aligned address: 0x2222400
参阅
| (C++11) |
定义适于用作给定大小的类型的未初始化存储的类型 (类模板) |
