Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

alignas — especificar o alinhamento

alignas especifica um requisito de alinhamento para uma variável, um membro de dados ou uma classe. Aceita um tipo ou uma expressão constante integral e não pode enfraquecer o alinhamento natural do objeto ou tipo declarado.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

O alinhamento restringe os endereços onde os objetos podem ser colocados. alignas especifica um requisito de alinhamento, enquanto alignof o consulta. Pode aplicar alignas a uma variável, a um membro de dados ou a uma classe, mas não a uma função, a um parâmetro de função, a um campo de bits ou a uma declaração de exceção em catch.

alignas(T) equivale a alignas(alignof(T)). Na forma numérica, o argumento tem de ser uma expressão constante integral: 0 não tem efeito e um valor diferente de zero tem de indicar um alinhamento suportado. Nem todas as potências de dois são suportadas em todos os contextos; os alinhamentos estendidos dependem da implementação.

Quando existem vários especificadores, aplica-se o alinhamento não nulo mais estrito. Em conjunto, não podem enfraquecer o requisito natural. A forma que contém ... expande um pacote. Se alguma declaração especificar um alinhamento, a definição tem de especificar um alinhamento equivalente; uma declaração que não seja uma definição pode omiti-lo.

O exemplo verifica uma relação em vez de uma quantidade de bytes dependente da plataforma. O array bytes continua a ser um array de bytes: o alinhamento, por si só, não cria um objeto double. A fonte é um projeto de norma em evolução, não uma publicação C++23 imutável.

Exemplos

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

Resultado

true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes