WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

alignas — Ausrichtung festlegen

alignas legt eine Ausrichtungsanforderung für eine Variable, ein Datenelement oder eine Klasse fest. Es akzeptiert einen Typ oder einen ganzzahligen konstanten Ausdruck und darf die natürliche Ausrichtung des deklarierten Objekts oder Typs nicht abschwächen.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

alignas(type-id)
alignas(constant-expression)
alignas(pack ...)

Die Ausrichtung begrenzt die Adressen, an denen Objekte platziert werden dürfen. alignas legt eine Ausrichtungsanforderung fest, während alignof sie abfragt. alignas kann für Variablen, Datenelemente und Klassen verwendet werden, jedoch nicht für Funktionen, Funktionsparameter, Bitfelder oder Exception-Deklarationen in catch.

alignas(T) ist gleichbedeutend mit alignas(alignof(T)). Bei der numerischen Form muss das Argument ein ganzzahliger konstanter Ausdruck sein: 0 hat keine Wirkung, und ein Wert ungleich null muss eine unterstützte Ausrichtung bezeichnen. Nicht jede Zweierpotenz wird in jedem Kontext unterstützt; erweiterte Ausrichtungen sind implementierungsabhängig.

Bei mehreren Spezifizierern gilt die strengste nicht nullwertige Ausrichtung. Zusammen dürfen sie die natürliche Anforderung nicht abschwächen. Die Form mit ... erweitert ein Parameterpaket. Wenn eine Deklaration eine Ausrichtung angibt, muss die Definition eine gleichwertige Ausrichtung angeben; eine Deklaration, die keine Definition ist, darf sie weglassen.

Das Beispiel prüft eine Beziehung statt einer plattformabhängigen Anzahl von Bytes. Das Array bytes bleibt ein Byte-Array: Durch die Ausrichtung allein entsteht kein double-Objekt. Die Quelle ist ein fortgeschriebener Standardentwurf, keine unveränderliche C++23-Veröffentlichung.

Beispiele

#include <iostream>

struct alignas(double) Storage {
    unsigned char bytes[sizeof(double)];
};

static_assert(alignof(Storage) >= alignof(double));

int main() {
    std::cout << std::boolalpha
              << (alignof(Storage) >= alignof(double)) << '\n';
}

Ergebnis

true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen