Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

alignas — specificare l’allineamento

alignas specifica un requisito di allineamento per una variabile, un membro dati o una classe. Accetta un tipo o un’espressione costante integrale e non può indebolire l’allineamento naturale dell’oggetto o del tipo dichiarato.

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

Sintassi

alignas(type-id)
alignas(constant-expression)
alignas(pack ...)

L’allineamento limita gli indirizzi in cui è possibile collocare gli oggetti. alignas specifica un requisito di allineamento, mentre alignof lo interroga. È possibile applicare alignas a una variabile, a un membro dati o a una classe, ma non a una funzione, a un parametro di funzione, a un campo di bit o a una dichiarazione di eccezione in catch.

alignas(T) equivale a alignas(alignof(T)). Nella forma numerica, l’argomento deve essere un’espressione costante integrale: 0 non ha effetto e un valore diverso da zero deve indicare un allineamento supportato. Non tutte le potenze di due sono supportate in ogni contesto; gli allineamenti estesi dipendono dall’implementazione.

In presenza di più specificatori, si applica l’allineamento non nullo più restrittivo. Nel loro insieme non possono indebolire il requisito naturale. La forma che contiene ... espande un pacchetto. Se una dichiarazione specifica un allineamento, la definizione deve specificare un allineamento equivalente; una dichiarazione che non è una definizione può ometterlo.

L’esempio verifica una relazione invece di un numero di byte dipendente dalla piattaforma. L’array bytes rimane un array di byte: il solo allineamento non crea un oggetto double. La fonte è una bozza di standard in evoluzione, non una pubblicazione C++23 immutabile.

Esempi

#include <iostream>

struct alignas(double) Storage {
    unsigned char bytes[sizeof(double)];
};

static_assert(alignof(Storage) >= alignof(double));

int main() {
    std::cout << std::boolalpha
              << (alignof(Storage) >= alignof(double)) << '\n';
}

Risultato

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.

Fonti