std::has_unique_object_representations

template< class T >
struct has_unique_object_representations;

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 are the same.

It is implementation-defined which scalar types satisfy this trait, but unsigned 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.

Template parameters

Helper variable template

template< class T >
inline constexpr bool has_unique_object_representations_v = has_unique_object_representations<T>::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.

Example

#include <iostream>
#include <type_traits>
 
struct foo
{
    char c;
    float f;
    short st;
    int i;
};
 
struct bar
{
    int a;
    int b;
};
 
int main()
{   
     std::cout  << std::boolalpha 
                << "Does foo have unique object representations? "
                << std::has_unique_object_representations_v<foo> << '\n'
                << "Does bar have unique object representations? " 
                << std::has_unique_object_representations_v<bar> << '\n';
}

Does foo have unique object representations? false
Does bar have unique object representations? true

See also