CKTIS / C++
alignof — požiadavka na zarovnanie typu
Operátor alignof zisťuje pri kompilácii požiadavku na zarovnanie typu v bajtoch. Vracia hodnotu typu std::size_t, nie veľkosť objektu. Pri poli udáva zarovnanie jeho prvkov; pri referenčnom type zarovnanie typu, na ktorý referencia odkazuje.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
alignof(type-id)alignof(T) udáva požiadavku na zarovnanie typu T ako úplného objektového typu. Zarovnanie obmedzuje adresy, na ktorých možno objekty umiestniť; väčšia hodnota znamená prísnejšiu požiadavku. Konkrétne hodnoty závisia od implementácie — nepredpokladajte, že alignof(int) je vždy 4.
Operand musí označovať úplný objektový typ, pole prvkov takého typu alebo referenciu na jeden z týchto typov. void, funkčné typy a neúplné triedy nie sú povolené. Zátvorky sú povinné. Štandardné C++ tu očakáva typ, nie výraz: pre premennú x použite alignof(decltype(x)), nie alignof(x).
Výsledok je prvalue typu std::size_t a celočíselný konštantný výraz, takže sa hodí pre constexpr a static_assert. Pri poli je výsledkom zarovnanie prvku; pri referencii zarovnanie typu, na ktorý odkazuje. Samotný operátor nevyžaduje žiadnu hlavičku; <cstddef> deklaruje názov std::size_t.
Nezamieňajte dopyt alignof(T) s sizeof(T), ktorý udáva veľkosť, ani s alignas(T), ktorý určuje zarovnanie deklarovanej entity. alignof zarovnanie nemení ani nekontroluje konkrétnu adresu. Príklad porovnáva zaručené vzťahy namiesto vypisovania hodnôt závislých od platformy. Dodané zdroje sú priebežne aktualizovaný pracovný návrh, nie zmrazené vydanie C++23.
Prí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ýsledok
true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.