Namespaces
Variants
Views
Actions

std::remove_cvref

From cppreference.com
< cpp‎ | types
 
 
Metaprogramming library
Type traits
Type categories
(C++11)
(C++14)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Type properties
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(until C++20*)
(C++11)(deprecated in C++20)
(C++11)
Type trait constants
Metafunctions
(C++17)
Supported operations
Relationships and property queries
Type modifications
(C++11)(C++11)(C++11)
Type transformations
(C++11)(deprecated in C++23)
(C++11)(deprecated in C++23)
(C++11)
remove_cvref
(C++20)
(C++11)
(C++17)

(C++11)(until C++20*)(C++17)
Compile-time rational arithmetic
Compile-time integer sequences
 
Defined in header <type_traits>
template< class T >
struct remove_cvref;
(since C++20)

If the type T is a reference type, provides the member typedef type which is the type referred to by T with its topmost cv-qualifiers removed. Otherwise type is T with its topmost cv-qualifiers removed.

If the program adds specializations for std::remove_cvref, the behavior is undefined.

Contents

[edit] Member types

Name Definition
type the type referred by T or T itself if it is not a reference, with top-level cv-qualifiers removed

[edit] Helper types

template< class T >
using remove_cvref_t = typename remove_cvref<T>::type;
(since C++20)

[edit] Possible implementation

template<class T>
struct remove_cvref
{
    typedef std::remove_cv_t<std::remove_reference_t<T>> type;
};

[edit] Notes

Feature-test macro Value Std Feature
__cpp_lib_remove_cvref 201711L (C++20) std::remove_cvref

[edit] Example

#include <type_traits>
 
int main()
{
    static_assert(std::is_same_v<std::remove_cvref_t<int>, int>);
    static_assert(std::is_same_v<std::remove_cvref_t<int&>, int>);
    static_assert(std::is_same_v<std::remove_cvref_t<int&&>, int>);
    static_assert(std::is_same_v<std::remove_cvref_t<const int&>, int>);
    static_assert(std::is_same_v<std::remove_cvref_t<const int[2]>, int[2]>);
    static_assert(std::is_same_v<std::remove_cvref_t<const int(&)[2]>, int[2]>);
    static_assert(std::is_same_v<std::remove_cvref_t<int(int)>, int(int)>);
}

[edit] See also

removes const and/or volatile specifiers from the given type
(class template) [edit]
removes a reference from the given type
(class template) [edit]
(C++11)
applies type transformations as when passing a function argument by value
(class template) [edit]