Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::align_val_t — tipo dell’argomento di allineamento della memoria

std::align_val_t, definito in <new>, trasporta un allineamento richiesto alle funzioni di allocazione e deallocazione sovraccaricate. È un tipo enumerativo distinto che consente di differenziare un argomento di allineamento da uno relativo alla dimensione della memoria.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#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 è un’enumerazione con ambito dichiarata in <new>, senza enumeratori con nome e con tipo sottostante std::size_t. Un valore come std::align_val_t{alignof(T)} indica l’allineamento richiesto in byte, non la dimensione dell’allocazione. Il tipo distinto permette di differenziare gli overload che accettano un allineamento da quelli che accettano una dimensione.

Per new T, quando l’allineamento del tipo supera __STDCPP_DEFAULT_NEW_ALIGNMENT__, la selezione della funzione di allocazione considera per primo un argomento di allineamento di tipo std::align_val_t. Gli overload specifici di una classe possono influenzare la selezione; il codice ordinario non deve passare manualmente questo argomento.

La chiamata diretta a ::operator new(size, alignment) alloca memoria, ma non invoca un costruttore per T. Libera la memoria con il corrispondente ::operator delete(ptr, alignment), passando lo stesso valore di allineamento. Non combinare queste funzioni con free, la normale deallocazione senza allineamento o le forme per array. In C++23, liberare memoria allocata dinamicamente può porre fine alla vita di un oggetto senza invocarne il distruttore, anche se quest’ultimo non è banale. La liberazione della memoria non invoca implicitamente il distruttore: le sue operazioni di pulizia non vengono quindi eseguite e i suoi altri effetti collaterali non si producono.

La conversione a std::align_val_t non verifica l’allineamento: passare un valore non valido alle funzioni di allocazione o deallocazione causa comportamento indefinito. Usa alignof(T) invece di indovinare i valori supportati. Nell’esempio, placement new inizializza un int, il risultato viene copiato e la memoria viene liberata prima della stampa. int non richiede una chiamata esplicita al distruttore.

Esempi

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

Risultato

42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti