Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::align_val_t — typ argumentu zarovnania pamäte

std::align_val_t z hlavičky <new> prenáša požadované zarovnanie do preťažení funkcií na alokáciu a dealokáciu. Je to samostatný výčtový typ, ktorý umožňuje odlíšiť argument zarovnania od argumentu určujúceho veľkosť úložiska.

Verzia: 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 je výčtový typ s rozsahom platnosti deklarovaný v <new>, bez pomenovaných enumerátorov a so základným typom std::size_t. Hodnota ako std::align_val_t{alignof(T)} udáva požadované zarovnanie v bajtoch, nie veľkosť alokácie. Samostatný typ odlišuje preťaženia prijímajúce zarovnanie od tých, ktoré prijímajú veľkosť.

Pri new T, keď zarovnanie typu prekračuje __STDCPP_DEFAULT_NEW_ALIGNMENT__, výber alokačnej funkcie najprv zvažuje argument zarovnania typu std::align_val_t. Vlastné preťaženia pre triedu môžu výber ovplyvniť; bežný kód nemusí tento argument odovzdávať manuálne.

Priame volanie ::operator new(size, alignment) alokuje úložisko, ale nevyvolá konštruktor pre T. Uvoľnite toto úložisko zodpovedajúcim volaním ::operator delete(ptr, alignment) a odovzdajte rovnakú hodnotu zarovnania. Nekombinujte tieto funkcie s free, bežnou dealokáciou bez zarovnania ani s variantmi pre polia. V C++23 môže uvoľnenie dynamicky alokovaného úložiska ukončiť životnosť objektu bez volania jeho deštruktora, aj keď je deštruktor netriviálny. Uvoľnenie úložiska deštruktor implicitne nevolá, takže sa nevykonajú jeho čistiace operácie ani nenastanú jeho ďalšie vedľajšie účinky.

Konverzia na std::align_val_t zarovnanie nekontroluje: odovzdanie neplatnej hodnoty alokačným alebo dealokačným funkciám spôsobuje nedefinované správanie. Namiesto hádania podporovaných hodnôt použite alignof(T). V príklade placement new inicializuje int, výsledok sa skopíruje a úložisko sa pred výpisom uvoľní. Typ int nepotrebuje explicitné volanie deštruktora.

Prí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ýsledok

42

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje