alignas 說明符 (C++11 起)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

C++ 語言

通用主題
預處理器 註釋	關鍵詞 轉義序列
流程控制
條件執行語句
if	switch
迭代語句（迴圈）
for range-for (C++11)	while do-while
跳轉語句
continue - break	goto - return
函式
函式宣告
Lambda 函式表示式
inline 說明符
動態異常規範 (直到 C++17*)
noexcept 說明符 (C++11)
異常
throw 表示式 try 塊	catch 處理程式
名稱空間
名稱空間宣告	命名空間別名
型別
基本型別 列舉型別 函式型別	類/結構體型別 聯合型別
說明符
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
儲存期說明符
初始化
預設初始化 值初始化 零初始化 複製初始化 直接初始化	聚合初始化 列表初始化 (C++11)   常量初始化 引用初始化

表示式
值類別 求值順序	運算子 運算子優先順序
替代表示
字面量
布林字面量 - 整數字面量 - 浮點數字面量
字元字面量 - 字串字面量 - nullptr (C++11)
使用者定義 (C++11)
工具
屬性 (C++11)
型別
typedef 宣告
類型別名宣告 (C++11)
型別轉換
隱式轉換 static_cast const_cast	顯式轉換 dynamic_cast reinterpret_cast
記憶體分配
new 表示式	delete 表示式
類
類宣告 建構函式 this 指標	訪問說明符 friend 說明符
類特有的函式屬性
虛擬函式 override 說明符 (C++11)   final 說明符 (C++11)	explicit (C++11) static
特殊成員函式
預設建構函式 複製建構函式 移動建構函式 (C++11)	複製賦值 移動賦值 (C++11) 解構函式
模板
類模板 函式模板	模板特化 引數包 (C++11)
雜項
內聯彙編	C++ 歷史

 

宣告

概覽 宣告語法 宣告說明符序列 宣告符 衝突宣告 說明符 typedef inline virtual 函式說明符 explicit 函式說明符 friend constexpr (C++11) consteval (C++20) constinit (C++20) 儲存類說明符 翻譯單元區域性 (C++20) class/struct union enum decltype (C++11) auto (C++11) alignas (C++11) constvolatile 包索引說明符 (C++26)     細化型別說明符 屬性 (C++11)

宣告符 引用 指標 陣列 塊宣告 簡單宣告   →結構化繫結宣告 (C++17) 別名宣告 (C++11) 命名空間別名定義 using 宣告 using 指令 static_assert 宣告 (C++11) asm 宣告 不透明列舉宣告 (C++11) 其他宣告 名稱空間定義 函式宣告 類模板宣告 函式模板宣告 顯式模板例項化 (C++11) 顯式模板特化 連結規範 屬性宣告 (C++11) 空宣告

 

指定型別或物件的對齊要求。

語法

alignas( 表示式 )
alignas( 型別-id )
alignas( 包 ... )

1) 表示式 必須是整型常量表達式，求值為零，或為對齊或擴充套件對齊的有效值。

2) 等價於 alignas(alignof( 型別-id ))。

3) 等價於應用於同一宣告的多個 alignas 說明符，每個引數包成員一個，引數包可以是型別或非型別引數包。

解釋

alignas 說明符可應用於

• 類的宣告或定義；
• 非位域類資料成員的宣告；
• 變數的宣告，但不能應用於以下情況
  • 函式引數；
  • catch 子句的異常引數。

由此宣告宣告的物件或型別將具有其對齊要求等於宣告中使用的所有 alignas 說明符中最嚴格（最大）的非零 表示式，除非它會削弱型別的自然對齊。

如果宣告中最嚴格（最大）的 alignas 比沒有 alignas 說明符的對齊（即比其自然對齊或比同一物件或型別的另一個宣告上的 alignas 弱）弱，則程式格式錯誤。

struct alignas(8) S {};
struct alignas(1) U { S s; }; // error: alignment of U would have been 8 without alignas(1)

無效的非零對齊，例如 alignas(3)，是格式錯誤的。

比同一宣告上的另一個 alignas 弱的有效非零對齊被忽略。

alignas(0) 始終被忽略。

注意

根據 ISO C11 標準，C 語言有 _Alignas 關鍵字，並在標頭檔案 <stdalign.h> 中將 alignas 定義為擴充套件到該關鍵字的預處理器宏。

在 C++ 中，這是一個關鍵字，並且

標頭檔案 <stdalign.h> 和 <cstdalign> 不定義此類宏。但是，它們確實定義了宏常量 __alignas_is_defined。	(C++20 前)
標頭檔案 <stdalign.h> 不定義此類宏。但是，它確實定義了宏常量 __alignas_is_defined。	(C++20 起)

關鍵詞

alignas

示例

執行此程式碼

#include <iostream>
 
// Every object of type struct_float will be aligned
// to alignof(float) boundary (usually 4):
struct alignas(float) struct_float
{
    // your definition here
};
 
// Every object of type sse_t will be aligned to 32-byte boundary:
struct alignas(32) sse_t
{
    float sse_data[4];
};
 
int main()
{
    struct default_aligned
    {
        float data[4];
    } a, b, c;
    sse_t x, y, z;
 
    std::cout
        << "alignof(struct_float) = " << alignof(struct_float) << '\n'
        << "sizeof(sse_t) = " << sizeof(sse_t) << '\n'
        << "alignof(sse_t) = " << alignof(sse_t) << '\n'
        << std::hex << std::showbase
        << "&a: " << &a << "\n"
           "&b: " << &b << "\n"
           "&c: " << &c << "\n"
           "&x: " << &x << "\n"
           "&y: " << &y << "\n"
           "&z: " << &z << '\n';
}

可能的輸出

alignof(struct_float) = 4
sizeof(sse_t) = 32
alignof(sse_t) = 32
&a: 0x7fffcec89930
&b: 0x7fffcec89940
&c: 0x7fffcec89950
&x: 0x7fffcec89960
&y: 0x7fffcec89980
&z: 0x7fffcec899a0

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
CWG 1437	C++11	alignas 可用於別名宣告	已禁止
CWG 2354	C++11	alignas 可應用於列舉宣告	已禁止

參考

• C++23 標準 (ISO/IEC 14882:2024)

• 9.12.4 攜帶依賴屬性 [dcl.attr.depend]

• C++20 標準 (ISO/IEC 14882:2020)

• 9.12.3 攜帶依賴屬性 [dcl.attr.depend]

• C++17 標準 (ISO/IEC 14882:2017)

• 10.6.3 攜帶依賴屬性 [dcl.attr.depend]

• C++14 標準 (ISO/IEC 14882:2014)

• 7.6.4 攜帶依賴屬性 [dcl.attr.depend]

• C++11 標準 (ISO/IEC 14882:2011)

• 7.6.4 攜帶依賴屬性 [dcl.attr.depend]

另見

alignof (C++11)	查詢型別的對齊要求 (運算子)
alignment_of (C++11)	獲取型別的對齊要求 (類模板)
C 文件 用於 _Alignas, alignas