CKTIS / C++
std::align_val_t — type voor het geheugenuitlijningsargument
std::align_val_t uit <new> geeft een vereiste uitlijning door aan overloads voor allocatie en deallocatie. Het is een afzonderlijk enumeratietype waarmee overloads een uitlijningsargument kunnen onderscheiden van een argument voor de opslaggrootte.
Versie: 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 is een scoped enumeratie die in <new> is gedeclareerd, zonder benoemde enumerators en met std::size_t als onderliggend type. Een waarde zoals std::align_val_t{alignof(T)} geeft de vereiste uitlijning in bytes door, niet de grootte van de allocatie. Het afzonderlijke type onderscheidt overloads die uitlijning accepteren van overloads die een grootte accepteren.
Bij new T, wanneer de uitlijning van het type groter is dan __STDCPP_DEFAULT_NEW_ALIGNMENT__, kijkt de selectie van de allocatiefunctie eerst naar een uitlijningsargument van het type std::align_val_t. Eigen overloads voor een klasse kunnen de selectie beïnvloeden; gewone code hoeft dit argument niet handmatig mee te geven.
Een directe aanroep van ::operator new(size, alignment) reserveert opslag, maar roept geen constructor voor T aan. Geef die opslag vrij met de bijbehorende ::operator delete(ptr, alignment) en geef dezelfde uitlijningswaarde mee. Combineer deze functies niet met free, gewone deallocatie zonder uitlijning of arrayvarianten. In C++23 kan het vrijgeven van dynamisch toegewezen opslag de levensduur van een object beëindigen zonder zijn destructor aan te roepen, ook als die destructor niet-triviaal is. Bij het vrijgeven van de opslag wordt de destructor niet impliciet aangeroepen, zodat zijn opruimwerk en andere neveneffecten uitblijven.
Een conversie naar std::align_val_t controleert de uitlijning niet: een ongeldige waarde doorgeven aan allocatie- of deallocatiefuncties leidt tot ongedefinieerd gedrag. Gebruik alignof(T) in plaats van ondersteunde waarden te raden. In het voorbeeld initialiseert placement new een int, wordt het resultaat gekopieerd en wordt de opslag vrijgegeven voordat er wordt afgedrukt. int vereist geen expliciete aanroep van de destructor.
Voorbeelden
#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';
}
Resultaat
42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.