_Alignas (since C11) (deprecated in C23) , alignas (since C23)

オブジェクトの 宣言 構文において、宣言されるオブジェクトの アライメント要件 を修飾する型指定子の一つとして現れます。

構文

説明

_Alignas (C23まで) alignas (C23以降) 指定子は、 ビットフィールド ではないオブジェクトの宣言時のみ使用でき、 register ストレージクラスを持つことはできません。関数パラメータ宣言では使用できず、typedefでも使用できません。

宣言で使用された場合、宣言されたオブジェクトは アライメント要件 が次のように設定されます

自然に持っていたはずの型のアライメントを弱める場合を除く。

expression がゼロと評価された場合、この指定子は効果を持ちません。

複数の _Alignas (C23まで) alignas (C23以降) 指定子が同じ宣言内に現れる場合、最も厳格なものが使用されます。

_Alignas (C23まで) alignas (C23以降) 指定子はオブジェクトの 定義 にのみ現れる必要がありますが、いずれかの宣言で _Alignas (C23まで) alignas (C23以降) を使用する場合、定義の _Alignas (C23まで) alignas (C23以降) と同じアラインメントを指定しなければなりません。同じオブジェクトに対して異なる翻訳単位が異なるアラインメントを指定した場合、動作は未定義です。

注記

C++では、 alignas 指定子はクラス/構造体/共用体型および列挙型の宣言にも適用できます。これはCではサポートされていませんが、構造体型のアラインメントはメンバー宣言で _Alignas (C23まで) alignas (C23以降) を使用して制御できます。

キーワード

alignas , _Alignas

例

#include <stdalign.h>
#include <stdio.h>
// every object of type struct sse_t will be aligned to 16-byte boundary
// (note: needs support for DR 444)
struct sse_t
{
    alignas(16) float sse_data[4];
};
// every object of type struct data will be aligned to 128-byte boundary
struct data
{
    char x;
    alignas(128) char cacheline[128]; // over-aligned array of char,
                                      // not array of over-aligned chars
};
int main(void)
{
    printf("sizeof(data) = %zu (1 byte + 127 bytes padding + 128-byte array)\n",
           sizeof(struct data));
    printf("alignment of sse_t is %zu\n", alignof(struct sse_t));
    alignas(2048) struct data d; // this instance of data is aligned even stricter
    (void)d; // suppresses "maybe unused" warning
}

sizeof(data) = 256 (1 byte + 127 bytes padding + 128-byte array)
alignment of sse_t is 16

不具合報告

以下の動作変更に関する欠陥報告書は、以前に公開されたC規格に対して遡及的に適用されました。

参考文献

関連項目