CKTIS / C++
std::decay e std::decay_t — transformação de tipo que modela a passagem por valor
std::decay transforma um tipo em tempo de compilação para modelar a passagem por valor. std::decay_t disponibiliza o tipo resultante sem ser necessário escrever ::type.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <type_traits>
template<class T> struct decay;
template<class T> using decay_t = typename decay<T>::type; // in namespace std
using Result = std::decay_t<T>;std::decay<T> de <type_traits> disponibiliza o resultado como type; std::decay_t<T> é um alias desse resultado. A transformação aplica-se a um tipo, não a um objeto, e não efetua qualquer cópia.
Primeiro, considere-se U = std::remove_reference_t<T>. Para um array, o resultado é std::remove_extent_t<U>*; para uma função, std::add_pointer_t<U>; nos restantes casos, std::remove_cv_t<U>.
Só são removidos os qualificadores de nível superior, não os do objeto apontado. Os arrays multidimensionais perdem apenas a primeira dimensão. std::remove_cvref_t<T> não converte tipos de array nem de função em tipos de ponteiro. std::decay_t<T> converte tipos de array em tipos de ponteiro, mas só o faz para tipos de função quando std::add_pointer_t<U> pode formar um tipo de ponteiro. Os tipos de função com qualificadores cv ou de referência, como void() const, permanecem inalterados. O ponteiro resultante não prolonga o tempo de vida do objeto apontado.
Exemplos
#include <type_traits>
using Function = int(double);
static_assert(std::is_same_v<typename std::decay<const int&>::type, int>);
static_assert(std::is_same_v<std::decay_t<const int(&)[3]>, const int*>);
static_assert(std::is_same_v<std::decay_t<Function&>, int(*)(double)>);
static_assert(std::is_same_v<std::decay_t<int[2][3]>, int(*)[3]>);
static_assert(std::is_same_v<std::decay_t<const int* const&>, const int*>);
static_assert(std::is_same_v<std::remove_cvref_t<int(&)[3]>, int[3]>);
int main() {}
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.