Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła