CKTIS / C++
std::decay und std::decay_t — Typumwandlung entsprechend der Übergabe als Wert
std::decay wandelt einen Typ zur Compilezeit um und bildet damit eine Übergabe als Wert nach. std::decay_t stellt den resultierenden Typ bereit, ohne dass ::type geschrieben werden muss.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#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> aus <type_traits> stellt sein Ergebnis als type bereit; std::decay_t<T> ist ein Alias für dieses Ergebnis. Es wird ein Typ umgewandelt, kein Objekt, und es wird keine Kopie erstellt.
Setze zunächst U = std::remove_reference_t<T>. Für ein Array lautet das Ergebnis std::remove_extent_t<U>*, für eine Funktion std::add_pointer_t<U> und in allen anderen Fällen std::remove_cv_t<U>.
Entfernt werden nur Qualifizierer der obersten Ebene, nicht die Qualifizierer des referenzierten Objekts. Mehrdimensionale Arrays verlieren nur ihre erste Dimension. std::remove_cvref_t<T> wandelt weder Array- noch Funktionstypen in Zeigertypen um. std::decay_t<T> wandelt Arraytypen in Zeigertypen um; bei Funktionstypen geschieht das nur, wenn std::add_pointer_t<U> einen Zeigertyp bilden kann. Funktionstypen mit cv- oder Referenzqualifizierern wie void() const bleiben unverändert. Ein resultierender Zeiger verlängert nicht die Lebensdauer des Objekts, auf das er zeigt.
Beispiele
#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() {}
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.