std::is_layout_compatible

来自cppreference.com
< cpp‎ | types
 
 
元编程库
类型特征
类型类别
(C++11)
(C++14)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(C++20 前*)
(C++11)(C++20 中弃用)
(C++11)
类型特征常量
元函数
(C++17)
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)(C++23 中弃用)
(C++11)(C++23 中弃用)
(C++11)
(C++11)
(C++17)

(C++11)(C++20 前*)(C++17)
编译时有理数算术
编译时整数序列
 
在标头 <type_traits> 定义
template< class T, class U >
struct is_layout_compatible;
(C++20 起)

如果 TU布局兼容的类型,那么提供的成员常量 value 等于 true。否则,value 等于 false

每个类型均与其任意 cv 限定版本布局兼容,即使它不是对象类型。

如果 T 或 U 不是完整类型,(可有 cv 限定的)void 或未知边界数组,那么行为未定义。

如果上述模板的实例化直接或间接地依赖于不完整类型,并且假设在该类型完整的情况下实例化就会产生不同的结果,那么行为未定义。

如果程序添加了 std::is_layout_compatiblestd::is_layout_compatible_v 的特化,那么行为未定义。

辅助变量模板

template< class T, class U >
inline constexpr bool is_layout_compatible_v = is_layout_compatible<T, U>::value;
(C++20 起)

继承自 std::integral_constant

成员常量

value
[静态]
如果 TU 布局兼容那么是 true,否则是 false
(公开静态成员常量)

成员函数

operator bool
将对象转换到 bool,返回 value
(公开成员函数)
operator()
(C++14)
返回 value
(公开成员函数)

成员类型

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

注解

有符号整数类型与其无符号对应类型之间并非布局兼容。char 既不与 signed char 也不与 unsigned char 布局兼容。

相似类型之间,如果它们在忽略顶层 cv 限定后不是同一类型,则并非布局兼容。

枚举类型与其底层类型非布局兼容。

具有布局兼容但不相同(忽略 cv 限定)的元素类型的数组类型之间并非布局兼容,即使它们长度相等。

功能特性测试 标准 功能特性
__cpp_lib_is_layout_compatible 201907L (C++20) std::is_layout_compatible

示例

#include <iomanip>
#include <iostream>
#include <type_traits>
 
struct Foo
{
    int x;
    char y;
};
 
struct FooNua
{
    int x;
    [[no_unique_address]] char y;
};
 
class Bar
{
    const int u = 42;
    volatile char v = '*';
};
 
enum E0 : int {};
enum class E1 : int {};
 
static_assert
(
    std::is_layout_compatible_v<const void, volatile void> == true  and
    std::is_layout_compatible_v<Foo, Bar>                  == true  and
    std::is_layout_compatible_v<Foo[2], Bar[2]>            == false and
    std::is_layout_compatible_v<int, E0>                   == false and
    std::is_layout_compatible_v<E0, E1>                    == true  and
    std::is_layout_compatible_v<long, unsigned long>       == false and
    std::is_layout_compatible_v<char*, const char*>        == false and
    std::is_layout_compatible_v<char*, char* const>        == true  and
    std::is_layout_compatible_v<Foo, FooNua>               == false // Note [1]
);
 
// [1] MSVC 错误地断言失败
 
int main() {}

参阅

检查类型是否为标准布局类型
(类模板)