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

CKTIS / C++

alignof — requisito de alinhamento de um tipo

O operador alignof consulta, em tempo de compilação, o requisito de alinhamento de um tipo, em bytes. Devolve um valor do tipo std::size_t, não o tamanho do objeto. Para um array, indica o alinhamento dos elementos; para um tipo referência, o do tipo referenciado.

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

Sintaxe

alignof(type-id)

alignof(T) indica o requisito de alinhamento de T enquanto tipo de objeto completo. O alinhamento limita os endereços onde os objetos podem ser colocados; um valor maior significa um requisito mais rigoroso. Os valores concretos dependem da implementação — não parta do princípio de que alignof(int) é sempre 4.

O operando tem de designar um tipo de objeto completo, um array de elementos desse tipo ou uma referência a um destes tipos. void, os tipos função e as classes incompletas não são permitidos. Os parênteses são obrigatórios. O C++ standard espera aqui um tipo, não uma expressão: para uma variável x, use alignof(decltype(x)), não alignof(x).

O resultado é um prvalue do tipo std::size_t e uma expressão constante inteira, pelo que pode ser usado com constexpr e static_assert. Para um array, o resultado é o alinhamento do elemento; para uma referência, é o do tipo referenciado. O operador, por si só, não requer qualquer cabeçalho; <cstddef> declara o nome std::size_t.

Não confunda a consulta alignof(T) com sizeof(T), que indica o tamanho, nem com alignas(T), que especifica o alinhamento de uma entidade declarada. alignof não altera o alinhamento nem verifica um endereço específico. O exemplo compara relações garantidas em vez de apresentar números dependentes da plataforma. As fontes fornecidas são um rascunho de trabalho continuamente atualizado, não uma edição congelada de C++23.

Exemplos

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

Resultado

true
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