std::has_unique_object_representations

Defined in header `<type_traits>`
template< class T > struct has_unique_object_representations;		(since C++17)

std::has_unique_object_representations is an UnaryTypeTrait.

If T is TriviallyCopyable and if any two objects of type T with the same value have the same object representation, provides the member constant value equal true. For any other type, value is false.

For the purpose of this trait, two arrays have the same value if their elements have the same values, two non-union classes have the same value if their direct subobjects have the same value, and two unions have the same value if they have the same active member and the value of that member is the same.

It is implementation-defined which scalar types satisfy this trait, but unsigned (until C++20) integer types that do not use padding bits are guaranteed to have unique object representations.

The behavior is undefined if T is an incomplete type other than (possibly cv-qualified) void or array of unknown bound.

The behavior of a program that adds specializations for std::has_unique_object_representations or std::has_unique_object_representations_v is undefined.

Template parameters

T

-

a type to check

Helper variable template

template< class T > inline constexpr bool has_unique_object_representations_v = has_unique_object_representations<T>::value;		(since C++17)

Inherited from std::integral_constant

Member constants

value

[static]

true if T has unique object representations, false otherwise
(public static member constant)

Member functions

operator bool	converts the object to bool, returns value (public member function)
operator() (C++14)	returns value (public member function)

Member types

Type	Definition
`value_type`	bool
`type`	std::integral_constant<bool, value>

Notes

This trait was introduced to make it possible to determine whether a type can be correctly hashed by hashing its object representation as a byte array.

Feature-test macro	Value	Std	Comment
`__cpp_lib_has_unique_object_representations`	201606L	(C++17)	`std::has_unique_object_representations`

Example

Run this code

#include <cstdint>
#include <type_traits>
 
struct bar
{
    std::uint32_t a, b;
};
 
struct foo
{
    std::uint8_t c;
    std::uint16_t st;
    std::uint32_t i;
};
 
int main()
{
    static_assert(std::has_unique_object_representations_v<char>);
    static_assert(std::has_unique_object_representations_v<bar>);
    static_assert(!std::has_unique_object_representations_v<foo>);
 
    // Notable architectural divergence:
    static_assert(std::has_unique_object_representations_v<bool>); // x86
    // static_assert(!std::has_unique_object_representations_v<bool>); // ARM
}

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Metaprogramming library (C++11)
Diagnostics library
General utilities library
Strings library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Numerics library
Localizations library
Input/output library
Filesystem library (C++17)
Regular expressions library (C++11)
Concurrency support library (C++11)
Technical specifications
Symbols index
External libraries

is_standard_layout (C++11)	checks if a type is a standard-layout type (class template)
hash (C++11)	hash function object (class template)