Spec-Zone.ru › C++

alignof operator (начиная с C++11)

Запрашивает требования к выравниванию типа.

Синтаксис

alignof( type-id )

Возвращает значение типа std::size_t.

Пояснение

Возвращает выравнивание в байтах, требуемое для типа, указанного с помощью type-id, который является либо полным объектным типом, типом массива с полным типом элемента или ссылочным типом на один из этих типов.

Если тип является ссылочным, оператор возвращает выравнивание ссылочного типа; если тип является типом массива, возвращается требование к выравниванию типа элемента.

Примечания

См. раздел выравнивание, чтобы узнать о значении и свойствах значения, возвращаемого alignof.

Ключевые слова

alignof

Пример

#include <iostream>

struct Foo
{
    int   i;
    float f;
    char  c;
};

// Note: alignas(alignof(long double)) below can be
// simplified to alignas(long double) if desired.
struct alignas(alignof(long double)) Foo2
{
    // put your definition here
}; 

struct Empty {};

struct alignas(64) Empty64 {};

#define SHOW(expr) std::cout << #expr << " = " << (expr) << '\n'

int main()
{
    SHOW(alignof(char));
    SHOW(alignof(int*));
    SHOW(alignof(Foo));
    SHOW(alignof(Foo2));
    SHOW(alignof(Empty));
    SHOW(alignof(Empty64));
}

Возможный вывод:

alignof(char) = 1
alignof(int*) = 8
alignof(Foo) = 4
alignof(Foo2) = 16
alignof(Empty) = 1
alignof(Empty64) = 64

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

Отчёт Применён к Опубликованное поведение Корректное поведение
CWG 1305 C++11 type-id не мог представлять ссылку на массив
с неизвестной границей, но с полным типом элемента
разрешено

Ссылки

  • Стандарт C++23 (ISO/IEC 14882:2024):
    • 7.6.2.6 Alignof [expr.alignof]
  • Стандарт C++20 (ISO/IEC 14882:2020):
    • 7.6.2.5 Alignof [expr.alignof]
  • Стандарт C++17 (ISO/IEC 14882:2017):
    • 8.3.6 Alignof [expr.alignof]
  • Стандарт C++14 (ISO/IEC 14882:2014):
    • 5.3.6 Alignof [expr.alignof]
  • Стандарт C++11 (ISO/IEC 14882:2011):
    • 5.3.6 Alignof [expr.alignof]

См. также

Требование к выравниванию ограничивает адреса, по которым может быть выделен объект
alignas (C++11) указывает, что хранилище переменной должно быть выровнено на определённую величину
(спецификатор)
alignment_of
(C++11)
получает требования к выравниванию типа
(шаблон класса)
Документация по C для _Alignof, alignof operator

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/language/alignof

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API