命名空间
变体
操作

std::has_unique_object_representations

来自 cppreference.cn
< cpp‎ | 类型
 
C++
 
元编程库
类型特性
类型类别
(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++11)
(C++11)  
(C++11)
(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++17)
(C++23)
(C++11)(C++26 中已弃用)
(C++11)
(C++11)
(C++11)(直到 C++20*)
(C++11)(C++20 中已弃用)
(C++11)
(C++11)
(C++20)
(C++20)
(C++23)
has_unique_object_representations
(C++17)
类型特性常量
(C++11)(C++17)(C++11)(C++11)
元函数
(C++17)
(C++17)
(C++17)
支持的操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
类型转换
(C++11)(C++23 中已弃用)
(C++11)(C++23 中已弃用)
(C++11)
(C++20)
(C++11)(直到 C++20*)(C++17)

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

std::has_unique_object_representations 是一个 一元类型特性 (UnaryTypeTrait)。

如果 T 是可平凡复制的 (trivially copyable)，并且任何两个类型为 T 的对象，如果它们的值相同，则它们的对象表示 (object representation)也相同，则提供成员常量 value 等于 true。对于任何其他类型，value 为 false。

对于此特性，如果两个数组的元素值相同，则它们具有相同的值；如果两个非联合类的直接子对象具有相同的值，则它们具有相同的值；如果两个联合具有相同的活动成员，且该成员的值相同，则它们具有相同的值。

哪些标量类型满足此特性是实现定义的，但是无符号(直到 C++20)不使用填充位的整数类型保证具有唯一的对象表示。

如果 std::remove_all_extents_t<T> 是一个不完整类型，而不是（可能带有 cv 限定符的）void，则行为未定义。

如果程序为 std::has_unique_object_representations 或 std::has_unique_object_representations_v 添加特化，则行为未定义。

目录

[编辑] 模板参数

T - 要检查的类型

[编辑] 辅助变量模板

template< class T >

constexpr bool has_unique_object_representations_v =

    has_unique_object_representations<T>::value;
 (C++17 起)
[编辑]

继承自 std::integral_constant

成员常量

value
[静态]
 true 如果 T 具有唯一的对象表示，否则为 false
(public static 成员常量)

成员函数

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

成员类型

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

[编辑] 注解

引入此特性是为了判断一个类型是否可以通过将其对象表示作为字节数组进行哈希来正确地进行哈希。

特性测试宏 值 标准 特性
__cpp_lib_has_unique_object_representations 201606L (C++17) std::has_unique_object_representations

[编辑] 示例

运行此代码
#include <cstdint>
#include <type_traits>
 
struct unpadded
{
    std::uint32_t a, b;
};
 
struct likely_padded
{
    std::uint8_t c;
    std::uint16_t st;
    std::uint32_t i;
};
 
int main()
{
    // Every value of a char corresponds to exactly one object representation.
    static_assert(std::has_unique_object_representations_v<char>);
    // For IEC 559 floats, assertion passes because the value NaN has
    // multiple object representations.
    static_assert(!std::has_unique_object_representations_v<float>);
 
    // Should succeed in any sane implementation because unpadded
    // is typically not padded, and std::uint32_t cannot contain padding bits.
    static_assert(std::has_unique_object_representations_v<unpadded>);
    // Fails in most implementations because padding bits are inserted
    // between the data members c and st for the purpose of aligning st to 16 bits.
    static_assert(!std::has_unique_object_representations_v<likely_padded>);
 
    // Notable architectural divergence:
    static_assert(std::has_unique_object_representations_v<bool>);  // x86
 // static_assert(!std::has_unique_object_representations_v<bool>); // ARM
}

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
LWG 4113 C++17 T 可以是未知边界的数组
即使其元素类型不完整		 要求元素
类型完整

[编辑] 参阅

(C++11)
 检查类型是否为标准布局类型
(类模板) [编辑]
(C++11)
 哈希函数对象
(类模板) [编辑]
取自“https://cppreference.cn/mwiki/index.php?title=cpp/types/has_unique_object_representations&oldid=180849”