std::aligned_alloc

定义于头文件 <cstdlib>
void* aligned_alloc( std::size_t alignment, std::size_t size );
(C++17 起)

分配 size 字节的未初始化存储,其对齐以 alignment 指定。 size 参数必须是 alignment 的整数倍。

要求下列函数是线程安全的:

对这些分配或解分配特定存储单元的函数调用以单独全序出现,并且在此顺序中,每个解分配调用先发生于下个分配(若存在)。

(C++11 起)

目录

参数

alignment - 指定对齐。必须是实现支持的合法对齐。
size - 分配的字节数。 alignment 的整数倍。

返回值

成功时,返回指向新分配内存起始的指针。为避免内存泄漏,返回的指针必须由 free()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 addr:   %p\n", (void*)p1);
    std::free(p1);
 
    int* p2 = static_cast<int*>(std::aligned_alloc(1024, 1024*sizeof *p2));
    std::printf("1024-byte aligned addr: %p\n", (void*)p2);
    std::free(p2);
}

可能的输出:

default-aligned addr:   0x2221c20
1024-byte aligned addr: 0x2222000

参阅

定义适用作给定大小的类型的未初始化存储的类型
(类模板)
aligned_allocC 文档

版本历史

  • (当前 | 先前 2017年12月9日 (六) 01:58Fruderica讨论 | 贡献 . . (2,130字节) (+62). . (+ static_cast) (撤销)
  • 当前 | 先前) 2017年5月4日 (四) 08:34Fruderica讨论 | 贡献. . (2,068字节) (+2,068). . (以“{{cpp/title|aligned_alloc}} {{cpp/memory/navbar}} {{ddcl | header=cstdlib | since=c++17 | void* aligned_alloc( std::size_t alignment, std::size_t size ); }} 分配...”为内容创建页面)