CKTIS / C++
std::align_val_t — typ argumentu zarovnání paměti
std::align_val_t z hlavičky <new> předává požadované zarovnání přetíženým funkcím pro alokaci a dealokaci. Jde o samostatný výčtový typ, který umožňuje odlišit argument zarovnání od argumentu určujícího velikost úložiště.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 je výčtový typ s vlastním rozsahem platnosti (enum class), deklarovaný v <new>, bez pojmenovaných enumerátorů a se základním typem std::size_t. Hodnota jako std::align_val_t{alignof(T)} udává požadované zarovnání v bajtech, nikoli velikost alokace. Samostatný typ odlišuje přetížení přijímající zarovnání od těch, která přijímají velikost.
U new T, když zarovnání typu překračuje __STDCPP_DEFAULT_NEW_ALIGNMENT__, výběr alokační funkce nejprve zvažuje argument zarovnání typu std::align_val_t. Vlastní přetížení pro třídu mohou výběr ovlivnit; běžný kód nemusí tento argument předávat ručně.
Přímé volání ::operator new(size, alignment) alokuje úložiště, ale nevolá konstruktor pro T. Uvolněte toto úložiště odpovídajícím voláním ::operator delete(ptr, alignment) a předejte stejnou hodnotu zarovnání. Nekombinujte tyto funkce s free, běžnou dealokací bez zarovnání ani s variantami pro pole. V C++23 může uvolnění dynamicky alokovaného úložiště ukončit dobu života objektu bez volání jeho destruktoru, i když je destruktor netriviální. Uvolnění úložiště destruktor implicitně nevolá, takže se neprovede úklid ani nenastanou jiné vedlejší účinky destruktoru.
Převod na std::align_val_t zarovnání neověřuje: předání neplatné hodnoty alokačním nebo dealokačním funkcím způsobuje nedefinované chování. Místo odhadování podporovaných hodnot používejte alignof(T). V příkladu placement new inicializuje int, výsledek se zkopíruje a úložiště se před výpisem uvolní. Typ int nevyžaduje explicitní volání destruktoru.
Příklady
#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';
}
Výsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.