WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen