WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

alignof — Ausrichtungsanforderung eines Typs

Der Operator alignof ermittelt zur Compile-Zeit die Ausrichtungsanforderung eines Typs in Bytes. Er liefert einen Wert vom Typ std::size_t, nicht die Größe des Objekts. Bei einem Array wird die Ausrichtung der Elemente angegeben, bei einem Referenztyp die des referenzierten Typs.

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

Syntax

alignof(type-id)

alignof(T) gibt die Ausrichtungsanforderung von T als vollständigem Objekttyp an. Die Ausrichtung begrenzt die Adressen, an denen Objekte platziert werden dürfen; ein größerer Wert bedeutet eine strengere Anforderung. Die konkreten Werte sind implementierungsabhängig – nehmen Sie nicht an, dass alignof(int) immer 4 ergibt.

Der Operand muss einen vollständigen Objekttyp, ein Array solcher Elemente oder eine Referenz auf einen dieser Typen bezeichnen. void, Funktionstypen und unvollständige Klassen sind nicht zulässig. Klammern sind erforderlich. Standard-C++ erwartet hier einen Typ, keinen Ausdruck: Verwenden Sie für eine Variable x also alignof(decltype(x)) und nicht alignof(x).

Das Ergebnis ist ein prvalue vom Typ std::size_t und ein ganzzahliger konstanter Ausdruck; es eignet sich daher für constexpr und static_assert. Bei einem Array ist das Ergebnis die Ausrichtung des Elementtyps, bei einer Referenz die des referenzierten Typs. Der Operator selbst benötigt keinen Header; <cstddef> deklariert den Namen std::size_t.

Verwechseln Sie die Abfrage alignof(T) nicht mit sizeof(T), das die Größe angibt, oder mit alignas(T), das die Ausrichtung einer deklarierten Entität festlegt. alignof ändert weder die Ausrichtung noch prüft es eine bestimmte Adresse. Das Beispiel vergleicht garantierte Zusammenhänge, statt plattformabhängige Zahlen auszugeben. Die bereitgestellten Quellen sind ein fortlaufend aktualisierter Arbeitsentwurf und keine eingefrorene C++23-Ausgabe.

Beispiele

#include <cstddef>
#include <iostream>

int main() {
    constexpr std::size_t alignment = alignof(int);
    static_assert(alignof(int[4]) == alignment);
    static_assert(alignof(int&) == alignment);

    std::cout << std::boolalpha
              << (alignof(int[4]) == alignment) << '\n'
              << (alignof(int&) == alignment) << '\n';
}

Ergebnis

true
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