CKTIS / C++
alignof — uitlijningsvereiste van een type
De operator alignof vraagt tijdens het compileren de uitlijningsvereiste van een type op, in bytes. De operator geeft een waarde van het type std::size_t terug, niet de grootte van het object. Voor een array geeft hij de uitlijning van de elementen; voor een referentietype die van het type waarnaar wordt verwezen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
alignof(type-id)alignof(T) geeft de uitlijningsvereiste van T als volledig objecttype. Uitlijning beperkt de adressen waarop objecten geplaatst mogen worden; een grotere waarde betekent een strengere vereiste. De concrete waarden zijn implementatieafhankelijk: ga er niet van uit dat alignof(int) altijd 4 is.
De operand moet een volledig objecttype, een array van zulke elementen of een referentie naar een van die typen aanduiden. void, functietypen en onvolledige klassen zijn niet toegestaan. Haakjes zijn verplicht. Standaard-C++ verwacht hier een type, geen expressie: gebruik voor een variabele x dus alignof(decltype(x)), niet alignof(x).
Het resultaat is een prvalue van het type std::size_t en een integrale constante expressie, waardoor het geschikt is voor constexpr en static_assert. Bij een array is het resultaat de uitlijning van het element; bij een referentie is het de uitlijning van het type waarnaar wordt verwezen. De operator zelf heeft geen header nodig; <cstddef> declareert de naam std::size_t.
Verwar de query alignof(T) niet met sizeof(T), dat de grootte aangeeft, of met alignas(T), dat de uitlijning van een gedeclareerde entiteit specificeert. alignof verandert de uitlijning niet en controleert geen specifiek adres. Het voorbeeld vergelijkt gegarandeerde relaties in plaats van platformafhankelijke getallen af te drukken. De aangeleverde bronnen zijn een voortdurend bijgewerkt werkdocument, geen bevroren C++23-editie.
Voorbeelden
#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';
}
Resultaat
true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.