aligned_alloc

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

动态内存管理

malloc

calloc

realloc

free

free_sized (C23)

free_aligned_sized (C23)

aligned_alloc (C11)

 

定义在头文件 <stdlib.h> 中
void *aligned_alloc( size_t alignment, size_t size );		(自 C11)

分配 size 字节的未初始化存储空间，其对齐方式由 alignment 指定。 size 参数必须是 alignment 的整数倍。

aligned_alloc 是线程安全的：它表现得好像只访问通过其参数可见的内存位置，而不访问任何静态存储空间。

先前对 free, free_sized, 和 free_aligned_sized(自 C23) 或 realloc 的调用，该调用释放一块内存，与调用 aligned_alloc 来分配相同或部分相同的内存区域同步。 此同步发生在释放函数访问内存之后，并在 aligned_alloc 访问内存之前。 对每个特定内存区域执行的所有分配和释放函数都有一个单一的总顺序。

参数

alignment	-	指定对齐方式。必须是实现支持的有效对齐方式。
size	-	要分配的字节数。 alignment 的整数倍

返回值

成功时，返回指向新分配的内存开始位置的指针。 为了避免内存泄漏，必须使用 free 或 realloc 释放返回的指针。

失败时，返回一个空指针。

备注

传递一个 size，它不是 alignment 的整数倍，或者传递一个 alignment，它不是有效的或不受实现支持，会导致函数失败并返回一个空指针（C11，如已发布，在此情况下指定了未定义的行为，这已通过 DR460 更正）。 删除大小限制以使其能够在限制性对齐边界处分配小对象（类似于 alignas）已由 N2072 提出。

作为“实现支持”要求的一个例子，POSIX 函数 posix_memalign 接受任何 alignment，它是一个 2 的幂，并且是 sizeof(void *) 的倍数，并且基于 POSIX 的 aligned_alloc 实现继承了此要求。

基本对齐方式始终受支持。 如果 alignment 是 2 的幂，并且不大于 _Alignof(max_align_t)，则 aligned_alloc 可能只是调用 malloc。

常规 malloc 将对齐内存，以适合具有基本对齐方式的任何对象类型。 aligned_alloc 用于过度对齐分配，例如对 SSE、缓存行或 VM 页面 边界进行过度对齐分配。

此函数在 Microsoft C 运行时库中不受支持，因为其对 std::free 的实现 无法处理任何类型的对齐分配。 相反，MS CRT 提供 _aligned_malloc（使用 _aligned_free 释放）。

示例

运行此代码

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    int *p1 = malloc(10*sizeof *p1);
    printf("default-aligned addr:   %p\n", (void*)p1);
    free(p1);
 
    int *p2 = aligned_alloc(1024, 1024*sizeof *p2);
    printf("1024-byte aligned addr: %p\n", (void*)p2);
    free(p2);
}

可能的输出

default-aligned addr:   0x1e40c20
1024-byte aligned addr: 0x1e41000

参考文献

• C23 标准 (ISO/IEC 9899:2024)

• 7.22.3.1 aligned_alloc 函数 (p: TBD)

• C17 标准 (ISO/IEC 9899:2018)

• 7.22.3.1 aligned_alloc 函数 (p: 253)

• C11 标准 (ISO/IEC 9899:2011)

• 7.22.3.1 aligned_alloc 函数 (p: 347-348)

参见

C++ 文档 用于 aligned_alloc