Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::align_val_t — tip argumenta za poravnavo pomnilnika

std::align_val_t iz glave <new> posreduje zahtevano poravnavo preobremenitvam za alokacijo in dealokacijo. Gre za ločen enumeracijski tip, ki omogoča razlikovanje argumenta za poravnavo od argumenta za velikost pomnilnika.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#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 enumeracija z obsegom, deklarirana v <new>, brez poimenovanih enumeratorjev in z osnovnim tipom std::size_t. Vrednost, kot je std::align_val_t{alignof(T)}, podaja zahtevano poravnavo v bajtih, ne velikosti alokacije. Ločen tip razlikuje preobremenitve, ki sprejemajo poravnavo, od tistih, ki sprejemajo velikost.

Pri new T, ko poravnava tipa presega __STDCPP_DEFAULT_NEW_ALIGNMENT__, izbira alokacijske funkcije najprej upošteva argument za poravnavo tipa std::align_val_t. Lastne preobremenitve za razred lahko vplivajo na izbiro; običajni kodi tega argumenta ni treba posredovati ročno.

Neposreden klic ::operator new(size, alignment) alocira pomnilnik, vendar ne pokliče konstruktorja za T. Pomnilnik sprostite z ustreznim ::operator delete(ptr, alignment) in posredujte isto vrednost poravnave. Teh funkcij ne mešajte s free, običajno dealokacijo brez poravnave ali različicami za polja. V C++23 lahko sprostitev dinamično dodeljenega pomnilnika konča življenjsko dobo objekta brez klica njegovega destruktorja, tudi če je destruktor netrivialen. Sprostitev pomnilnika destruktorja ne pokliče implicitno, zato se njegova opravila čiščenja ne izvedejo in njegovi drugi stranski učinki ne nastopijo.

Pretvorba v std::align_val_t ne preveri poravnave: posredovanje neveljavne vrednosti alokacijskim ali dealokacijskim funkcijam povzroči nedefinirano vedenje. Namesto ugibanja o podprtih vrednostih uporabite alignof(T). V primeru placement new inicializira int, rezultat se kopira, pomnilnik pa se sprosti pred izpisom. int ne potrebuje izrecnega klica destruktorja.

Primeri

#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';
}

Rezultat

42

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri