命名空间
变体
操作

std::alignment_of

来自 cppreference.cn
< cpp‎ | types
 
 
元编程库
类型特征
类型类别
(C++11)
(C++11)(DR*)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11) 
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)(在 C++26 中弃用)
(C++11)(直到 C++20*)
(C++11)(在 C++20 中弃用)
(C++11)
类型特征常量
元函数
(C++17)
支持的操作
关系和属性查询
(C++11)
alignment_of
(C++11)
(C++11)
(C++11)
类型修改
(C++11)(C++11)(C++11)
类型转换
(C++11)(在 C++23 中弃用)
(C++11)(在 C++23 中弃用)
(C++11)
(C++11)(直到 C++20*)(C++17)

(C++11)
(C++17)
编译时有理算术
编译时整数序列
 
定义于头文件 <type_traits>
template< class T >
struct alignment_of;
(自 C++11 起)

提供成员常量 value,其值等于类型 T对齐要求,如同通过 alignof 表达式获得。如果 T 是数组类型,则返回元素类型的对齐要求。如果 T 是引用类型,则返回被引用类型的对齐要求。

如果 alignof(T) 不是有效的表达式,则行为未定义。

如果程序为 std::alignment_ofstd::alignment_of_v(自 C++17 起) 添加特化,则行为未定义。

目录

[编辑] 辅助变量模板

template< class T >
constexpr std::size_t alignment_of_v = alignment_of<T>::value;
(自 C++17 起)

继承自 std::integral_constant

成员常量

value
[静态]
alignof(T)
(公共静态成员常量)

成员函数

operator std::size_t
将对象转换为 std::size_t,返回 value
(公共成员函数)
operator()
(C++14)
返回 value
(公共成员函数)

成员类型

类型 定义
value_type std::size_t
type std::integral_constant<std::size_t, value>

[编辑] 可能的实现

template<class T>
struct alignment_of : std::integral_constant<std::size_t, alignof(T)> {};

[编辑] 注释

这种类型特征早于 alignof 关键字,后者可以用更简洁的方式获得相同的值。

[编辑] 示例

#include <cstdint>
#include <iostream>
#include <type_traits>
 
struct A {};
struct B
{
    std::int8_t p;
    std::int16_t q;
};
 
int main()
{
    std::cout << std::alignment_of<A>::value << ' ';
    std::cout << std::alignment_of<B>::value << ' ';
    std::cout << std::alignment_of<int>() << ' '; // alt syntax
    std::cout << std::alignment_of_v<double> << '\n'; // c++17 alt syntax
}

可能的输出

1 2 4 8

[编辑] 参见

alignof (C++11) 查询类型的对齐要求
(运算符)[编辑]
alignas (C++11) 指定变量的存储应按特定数量对齐
(说明符)[编辑]
(自 C++11 起)(在 C++23 中弃用)
定义适合用作给定大小类型未初始化存储的类型
(类模板) [编辑]
(自 C++11 起)(在 C++23 中弃用)
定义适合用作所有给定类型未初始化存储的类型
(类模板) [编辑]
具有与任何其他标量类型一样大的对齐要求的平凡类型
(typedef) [编辑]