Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

alignof — požadavek na zarovnání typu

Operátor alignof zjišťuje při kompilaci požadavek na zarovnání typu v bajtech. Vrací hodnotu typu std::size_t, nikoli velikost objektu. U pole udává zarovnání jeho prvků; u referenčního typu zarovnání typu, na který reference odkazuje.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

alignof(type-id)

alignof(T) udává požadavek na zarovnání typu T jako úplného objektového typu. Zarovnání omezuje adresy, na kterých lze objekty umístit; větší hodnota znamená přísnější požadavek. Konkrétní hodnoty závisejí na implementaci — nepředpokládejte, že alignof(int) je vždy 4.

Operand musí označovat úplný objektový typ, pole prvků takového typu nebo referenci na jeden z těchto typů. void, funkční typy a neúplné třídy nejsou povoleny. Závorky jsou povinné. Standardní C++ zde očekává typ, nikoli výraz: pro proměnnou x použijte alignof(decltype(x)), ne alignof(x).

Výsledek je prvalue typu std::size_t a celočíselný konstantní výraz, takže jej lze použít s constexpr a static_assert. U pole je výsledkem zarovnání prvku; u reference zarovnání typu, na který odkazuje. Samotný operátor nevyžaduje žádnou hlavičku; <cstddef> deklaruje název std::size_t.

Nezaměňujte dotaz alignof(T) s sizeof(T), který udává velikost, ani s alignas(T), který určuje zarovnání deklarované entity. alignof zarovnání nemění ani nekontroluje konkrétní adresu. Příklad porovnává zaručené vztahy namísto vypisování hodnot závislých na platformě. Dodané zdroje jsou průběžně aktualizovaný pracovní návrh, nikoli zmrazené vydání C++23.

Příklady

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

Výsledek

true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje