CKTIS / C++
std::align_val_t — тип на аргумента за подравняване на паметта
std::align_val_t от <new> предава необходимото подравняване на претоварените функции за заделяне и освобождаване на памет. Това е отделен тип изброяване, който позволява аргументът за подравняване да се различи от аргумент за размера на паметта.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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 е изброяване с обхват, декларирано в <new>, без именувани изброители и с базов тип std::size_t. Стойност като std::align_val_t{alignof(T)} указва необходимото подравняване в байтове, а не размера на заделянето. Отделният тип разграничава претоварванията, които приемат подравняване, от тези, които приемат размер.
При new T, когато подравняването на типа надвишава __STDCPP_DEFAULT_NEW_ALIGNMENT__, изборът на функция за заделяне първо разглежда аргумент за подравняване от тип std::align_val_t. Собствените претоварвания за клас могат да повлияят на избора; обикновеният код не е необходимо да подава този аргумент ръчно.
Прякото извикване на ::operator new(size, alignment) заделя памет, но не извиква конструктор за T. Освободете тази памет със съответстващия ::operator delete(ptr, alignment), като подадете същата стойност за подравняване. Не комбинирайте тези функции с free, обикновено освобождаване без подравняване или вариантите за масиви. В C++23 освобождаването на динамично заделена памет може да прекрати живота на обект, без да извика деструктора му, дори той да е нетривиален. Освобождаването на паметта не извиква неявно деструктора, затова неговите операции по почистване не се изпълняват и останалите му странични ефекти не настъпват.
Преобразуването към std::align_val_t не проверява подравняването: подаването на невалидна стойност на функции за заделяне или освобождаване води до неопределено поведение. Използвайте alignof(T), вместо да гадаете кои стойности се поддържат. В примера placement new инициализира int, резултатът се копира, а паметта се освобождава преди отпечатването. За int не е необходимо изрично извикване на деструктор.
Примери
#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';
}
Резултат
42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.