memalignment

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

程序支持实用程序

程序终止
abort exit quick_exit (C11) _Exit (C99)	atexit at_quick_exit (C11) EXIT_SUCCESSEXIT_FAILURE
不可达控制流
unreachable (C23)
与环境通信
getenvgetenv_s (C11)	system
内存对齐查询
memalignment (C23)
信号
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
信号类型
SIGABRTSIGFPESIGILL	SIGINTSIGSEGVSIGTERM
非局部跳转
setjmp	longjmp
类型
jmp_buf

 

定义在头文件 <stdlib.h> 中
size_t memalignment( const void *p );		(自 C23 起)

返回提供的地址满足的最大对齐方式。返回值可能大于实现支持的任何对齐方式值。如果 p 是一个空指针值，则返回 ​0​ 以指示该指针不能用于访问任何类型的对象。

如果返回值与 alignof(T) 相比较大于或等于，则指针满足类型 T 的对齐要求。

一个 独立实现 需要提供 memalignment。

参数

p

-

指向要查询对齐方式的指针

返回值

p 的对齐方式值，或者如果 p 是一个空指针值，则为 ​0​。

备注

在常见的平台上，其中

• 空指针被强制转换为整数 ​0​，
• 指针值直接强制转换为虚拟地址的数值，并且
• size_t 与 uintptr_t 相同，

此函数可以实现为 return (size_t)p & -(size_t)p;.

示例

运行此代码

#include <stdio.h>
#include <stdlib.h>
 
int main()
{
    alignas(128) int i = 0;
    printf("%zu\n%zu\n", memalignment(nullptr), memalignment(&i));
}

可能的输出

0
128

参考

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

• 7.24.9.1 memalignment 函数 (p: 374)

另请参阅

aligned_alloc (C11)	分配对齐的内存 (函数)
free_aligned_sized (C23)	释放先前分配的已分配大小和对齐的内存 (函数)