alignof Operator (seit C++11)

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

C++ Sprache

Allgemeine Themen
Präprozessor Kommentare	Schlüsselwörter Escape-Sequenzen
Kontrollfluss
Bedingte Ausführungsaussagen
if	switch
Iterationsanweisungen (Schleifen)
for Bereichs-for (C++11)	while do-while
Sprunganweisungen
continue - break	goto - return
Funktionen
Funktionsdeklaration
Lambda-Funktionsausdruck
inline-Spezifizierer
Dynamische Ausnahmespezifikationen (bis C++17*)
noexcept-Spezifizierer (C++11)
Ausnahmen
throw-Ausdruck try-Block	catch-Handler
Namensräume
Namensdeklaration	Namensaliase
Typen
Fundamentale Typen Aufzählungstypen Funktionstypen	Klassen-/Strukturtypen Union-Typen
Spezifizierer
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
Speicherdauer-Spezifizierer
Initialisierung
Standardinitialisierung Wertinitialisierung Nullinitialisierung Kopierinitialisierung Direkte Initialisierung	Aggregatinitialisierung Listeninitialisierung (C++11)   Konstante Initialisierung Referenzinitialisierung

Ausdrücke
Wertkategorien Reihenfolge der Auswertung	Operatoren Operatorrangfolge
Alternative Darstellungen
Literale
Boolesch - Ganzzahl - Gleitkommazahl
Zeichen - String - nullptr (C++11)
Benutzerdefinierte (C++11)
Dienstprogramme
Attribute (C++11)
Typen
typedef-Deklaration
Typalias-Deklaration (C++11)
Umwandlungen
Implizite Konvertierungen static_cast const_cast	Explizite Konvertierungen dynamic_cast reinterpret_cast
Speicherzuweisung
new-Ausdruck	delete-Ausdruck
Klassen
Klassendeklaration Konstruktoren this-Zeiger	Zugriffsspezifizierer friend-Spezifizierer
Klassenspezifische Funktionseigenschaften
Virtuelle Funktion override-Spezifizierer (C++11)   final-Spezifizierer (C++11)	explicit (C++11) static
Spezielle Member-Funktionen
Standardkonstruktor Kopierkonstruktor Move-Konstruktor (C++11)	Kopierzuweisung Move-Zuweisung (C++11) Destruktor
Templates
Klassenschablone Funktionsschablone	Schablonenspezialisierung Parameter-Pakete (C++11)
Sonstiges
Inline-Assembler	Geschichte von C++

 

Ausdrücke

Allgemein
Wertkategorien Reihenfolge der Auswertung Konstante Ausdrücke Primärausdrücke	Lambda-Ausdrücke (C++11) Requires-Ausdrücke (C++20) Pack-Indizierungs-Ausdruck (C++26) Potenziell ausgewertete Ausdrücke
Literale
Ganzzahl-Literale Gleitkomma-Literale Boolesche Literale Zeichen-Literale	Escape-Sequenzen Zeichenketten-Literale Null-Zeiger-Literal (C++11) Benutzerdefinierte Literale (C++11)
Operatoren
Zuweisungsoperatoren Inkrement und Dekrement Arithmetische Operatoren Logische Operatoren Vergleichsoperatoren Member-Zugriffsoperatoren Andere Operatoren new-Ausdruck delete-Ausdruck throw-Ausdruck	alignof sizeof sizeof... (C++11) typeid noexcept (C++11) Falt-Ausdrücke (C++17) Alternative Darstellungen von Operatoren Priorität und Assoziativität Operatorüberladung Standardvergleiche (C++20)
Konvertierungen
Implizite Konvertierungen Explizite Konvertierungen Übliche arithmetische Konvertierungen     Benutzerdefinierte Konvertierung	const_cast static_cast dynamic_cast reinterpret_cast

 

Fragt die Ausrichtungsvoraussetzungen eines Typs ab.

Syntax

alignof( type-id )

Gibt einen Wert vom Typ std::size_t zurück.

Erklärung

Gibt die Ausrichtung in Bytes zurück, die für jede Instanz des durch type-id angegebenen Typs erforderlich ist. Dabei handelt es sich um einen vollständigen Objekttyp, einen Array-Typ, dessen Elementtyp vollständig ist, oder einen Referenztyp auf einen dieser Typen.

Wenn der Typ ein Referenztyp ist, gibt der Operator die Ausrichtung des referenzierten Typs zurück; wenn der Typ ein Array-Typ ist, wird die Ausrichtungsanforderung des Elementtyps zurückgegeben.

Hinweise

Siehe Ausrichtung für die Bedeutung und Eigenschaften des von alignof zurückgegebenen Werts.

Schlüsselwörter

alignof

Beispiel

Führen Sie diesen Code aus

#include <iostream>
 
struct Foo
{
    int   i;
    float f;
    char  c;
};
 
// Note: alignas(alignof(long double)) below can be
// simplified to alignas(long double) if desired.
struct alignas(alignof(long double)) Foo2
{
    // put your definition here
}; 
 
struct Empty {};
 
struct alignas(64) Empty64 {};
 
#define SHOW(expr) std::cout << #expr << " = " << (expr) << '\n'
 
int main()
{
    SHOW(alignof(char));
    SHOW(alignof(int*));
    SHOW(alignof(Foo));
    SHOW(alignof(Foo2));
    SHOW(alignof(Empty));
    SHOW(alignof(Empty64));
}

Mögliche Ausgabe

alignof(char) = 1
alignof(int*) = 8
alignof(Foo) = 4
alignof(Foo2) = 16
alignof(Empty) = 1
alignof(Empty64) = 64

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
CWG 1305	C++11	type-id konnte keine Referenz auf ein Array darstellen mit unbekannter Grenze, aber einem vollständigen Elementtyp	erlaubt

Referenzen

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

• 7.6.2.6 Alignof [expr.alignof]

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

• 7.6.2.5 Alignof [expr.alignof]

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

• 8.3.6 Alignof [expr.alignof]

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

• 5.3.6 Alignof [expr.alignof]

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

• 5.3.6 Alignof [expr.alignof]

Siehe auch

Ausrichtungsvoraussetzung	beschränkt die Adressen, an denen ein Objekt zugewiesen werden darf
alignas (C++11)	gibt an, dass der Speicher für die Variable um einen bestimmten Betrag ausgerichtet werden soll (Spezifizierer)
alignment_of (C++11)	erhält die Ausrichtungsvoraussetzungen des Typs (Klassenvorlage)
C-Dokumentation für _Alignof, alignof Operator