CKTIS / C++
alignof — wymaganie wyrównania typu
Operator alignof odczytuje w czasie kompilacji wymaganie wyrównania typu w bajtach. Zwraca wartość std::size_t, a nie rozmiar obiektu. Dla tablicy podaje wyrównanie elementu, a dla typu referencyjnego — wyrównanie typu wskazywanego przez referencję.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
alignof(type-id)alignof(T) podaje wymaganie wyrównania typu T jako typu kompletnego obiektu. Wyrównanie ogranicza adresy, pod którymi można umieszczać obiekty; większa wartość oznacza ostrzejsze wymaganie. Konkretne wartości zależą od implementacji — nie zakładaj, że alignof(int) zawsze wynosi 4.
Operand musi oznaczać kompletny typ obiektowy, tablicę takich elementów albo referencję do jednego z tych typów. Typy void, funkcje i niekompletne klasy są niedozwolone. Nawiasy są obowiązkowe. Standardowe C++ przyjmuje tutaj typ, nie wyrażenie: dla zmiennej x użyj alignof(decltype(x)), nie alignof(x).
Wynik jest wartością prvalue typu std::size_t i całkowitoliczbowym wyrażeniem stałym, więc nadaje się do constexpr i static_assert. Dla tablicy wynikiem jest wyrównanie elementu, a dla referencji — typu, do którego się odnosi. Sam operator nie wymaga nagłówka; <cstddef> deklaruje nazwę std::size_t.
Nie myl zapytania alignof(T) z sizeof(T), które podaje rozmiar, ani z alignas(T), które określa wyrównanie deklarowanej encji. alignof nie zmienia wyrównania ani nie sprawdza konkretnego adresu. Przykład porównuje gwarantowane zależności zamiast wypisywać liczby zależne od platformy. Podane źródła są aktualizowanym szkicem roboczym, a nie zamrożonym wydaniem C++23.
Przykłady
#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';
}
Wynik
true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.