WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::align_val_t — Typ für das Speicherausrichtungsargument

std::align_val_t aus <new> übermittelt eine erforderliche Ausrichtung an Überladungen für Allokation und Deallokation. Als eigener Enumerationstyp ermöglicht es, ein Ausrichtungsargument von einem Argument für die Speichergröße zu unterscheiden.

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

Syntax

#include <new>
// Declaration in namespace std:
enum class align_val_t : size_t {};

// Explicit aligned allocation and matching deallocation:
void* p = ::operator new(sizeof(T), std::align_val_t{alignof(T)});
::operator delete(p, std::align_val_t{alignof(T)});

std::align_val_t ist eine in <new> deklarierte Enumeration mit Gültigkeitsbereich, ohne benannte Enumeratoren und mit std::size_t als Basistyp. Ein Wert wie std::align_val_t{alignof(T)} gibt die erforderliche Ausrichtung in Byte an, nicht die Größe der Allokation. Durch den eigenen Typ lassen sich Überladungen für Ausrichtung von solchen für die Größe unterscheiden.

Bei new T, wenn die Ausrichtung des Typs __STDCPP_DEFAULT_NEW_ALIGNMENT__ überschreitet, berücksichtigt die Auswahl der Allokationsfunktion zuerst ein Ausrichtungsargument vom Typ std::align_val_t. Eigene klassenbezogene Überladungen können die Auswahl beeinflussen; gewöhnlicher Code muss dieses Argument nicht manuell übergeben.

Der direkte Aufruf von ::operator new(size, alignment) reserviert Speicher, ruft aber keinen Konstruktor für T auf. Geben Sie diesen Speicher mit dem passenden ::operator delete(ptr, alignment) frei und übergeben Sie dabei denselben Ausrichtungswert. Kombinieren Sie diese Funktionen nicht mit free, gewöhnlicher Deallokation ohne Ausrichtung oder Array-Varianten. In C++23 kann die Freigabe dynamisch reservierten Speichers die Lebensdauer eines Objekts beenden, ohne seinen Destruktor aufzurufen, auch wenn dieser nichttrivial ist. Durch die Speicherfreigabe wird der Destruktor nicht implizit aufgerufen; seine Aufräumarbeiten und sonstigen Seiteneffekte bleiben daher aus.

Eine Umwandlung in std::align_val_t prüft die Ausrichtung nicht: Ein ungültiger Wert, der an Allokations- oder Deallokationsfunktionen übergeben wird, führt zu undefiniertem Verhalten. Verwenden Sie alignof(T), statt unterstützte Werte zu erraten. Im Beispiel initialisiert placement new ein int; das Ergebnis wird kopiert und der Speicher vor der Ausgabe freigegeben. Für int ist kein expliziter Destruktoraufruf nötig.

Beispiele

#include <iostream>
#include <new>

int main() {
    constexpr auto alignment = std::align_val_t{alignof(int)};
    void* storage = ::operator new(sizeof(int), alignment);
    int* value = ::new (storage) int{42};
    const int result = *value;
    ::operator delete(storage, alignment);
    std::cout << result << '\n';
}

Ergebnis

42

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