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)	釋放之前分配的指定大小且對齊的記憶體 (函式)