CKTIS / C++
alignof — requisito di allineamento di un tipo
L’operatore alignof interroga in fase di compilazione il requisito di allineamento di un tipo, in byte. Restituisce un valore di tipo std::size_t, non la dimensione dell’oggetto. Per un array indica l’allineamento degli elementi; per un tipo riferimento, quello del tipo referenziato.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
alignof(type-id)alignof(T) indica il requisito di allineamento di T in quanto tipo di oggetto completo. L’allineamento limita gli indirizzi in cui è possibile collocare gli oggetti; un valore maggiore comporta un requisito più stringente. I valori effettivi dipendono dall’implementazione: non dare per scontato che alignof(int) sia sempre 4.
L’operando deve designare un tipo di oggetto completo, un array di elementi di tale tipo oppure un riferimento a uno di questi tipi. void, i tipi funzione e le classi incomplete non sono ammessi. Le parentesi sono obbligatorie. Il C++ standard richiede qui un tipo, non un’espressione: per una variabile x, usa alignof(decltype(x)), non alignof(x).
Il risultato è un prvalue di tipo std::size_t ed è un’espressione costante intera, quindi può essere usato con constexpr e static_assert. Per un array, il risultato è l’allineamento dell’elemento; per un riferimento, quello del tipo referenziato. L’operatore in sé non richiede intestazioni; <cstddef> dichiara il nome std::size_t.
Non confondere la query alignof(T) con sizeof(T), che indica la dimensione, né con alignas(T), che specifica l’allineamento di un’entità dichiarata. alignof non modifica l’allineamento e non verifica un indirizzo specifico. L’esempio confronta relazioni garantite invece di stampare valori dipendenti dalla piattaforma. Le fonti fornite sono una bozza di lavoro aggiornata continuamente, non un’edizione congelata di C++23.
Esempi
#include <cstddef>
#include <iostream>
int main() {
constexpr std::size_t alignment = alignof(int);
static_assert(alignof(int[4]) == alignment);
static_assert(alignof(int&) == alignment);
std::cout << std::boolalpha
<< (alignof(int[4]) == alignment) << '\n'
<< (alignof(int&) == alignment) << '\n';
}
Risultato
true true
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.