std::aligned_alloc

在标头 `<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("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

参阅

aligned_storage

(C++11)(C++23 中弃用)

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

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

std::aligned_alloc

参数

返回值

注解

示例

参阅

导航