CKTIS / C++
std::align_val_t — typ argumentu wyrównania pamięci
std::align_val_t z nagłówka <new> przenosi wymagane wyrównanie do przeciążeń funkcji alokacji i dealokacji. To odrębny typ wyliczeniowy, który pozwala odróżnić wyrównanie od rozmiaru pamięci.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 to zadeklarowany w <new> zakresowy typ wyliczeniowy bez nazwanych enumeratorów, z typem bazowym std::size_t. Wartość taką jak std::align_val_t{alignof(T)} przekazuje się jako wymagane wyrównanie w bajtach, a nie rozmiar alokacji. Odrębny typ rozróżnia przeciążenia przyjmujące wyrównanie i rozmiar.
Przy new T dla typu, którego wyrównanie przekracza __STDCPP_DEFAULT_NEW_ALIGNMENT__, mechanizm wyboru funkcji alokującej najpierw uwzględnia argument wyrównania typu std::align_val_t. Własne przeciążenia klasowe mogą wpływać na wybór; zwykły kod nie musi ręcznie przekazywać tego argumentu.
Bezpośrednie wywołanie ::operator new(size, alignment) przydziela pamięć, ale nie wywołuje konstruktora T. Pamięć trzeba zwolnić zgodnym ::operator delete(ptr, alignment), przekazując tę samą wartość wyrównania. Nie należy mieszać tych funkcji z free, zwykłą dealokacją bez wyrównania ani wariantami tablicowymi. W C++23 zwolnienie dynamicznie przydzielonej pamięci może zakończyć czas życia obiektu bez wywołania jego destruktora, nawet jeśli destruktor jest nietrywialny. Samo zwolnienie pamięci nie wywołuje destruktora automatycznie, więc nie następuje wykonywane przez niego sprzątanie ani żadne inne jego skutki uboczne.
Rzutowanie na std::align_val_t nie sprawdza poprawności wyrównania: nieprawidłowa wartość przekazana funkcjom alokacji lub dealokacji powoduje niezdefiniowane zachowanie. Korzystaj z alignof(T) zamiast zgadywać obsługiwane wartości. W przykładzie placement new inicjalizuje int, wynik jest kopiowany, a pamięć zwalniana przed wypisaniem. int nie wymaga jawnego wywołania destruktora.
Przykłady
#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';
}
Wynik
42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.