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.