Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes