WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::declval — Ausdrücke untersuchen, ohne ein Objekt zu erstellen

Mit std::declval aus <utility> lässt sich der Typ eines Ausdrucks untersuchen, ohne ein Objekt zu erstellen. Verwenden Sie es in nicht ausgewerteten Operanden wie decltype; für einen tatsächlichen ausgewerteten Aufruf darf es nicht verwendet werden.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <utility>

template<class T>
std::add_rvalue_reference_t<T> std::declval() noexcept;

std::declval<T>() aus <utility> dient dazu, Ausdrücke in nicht ausgewerteten Operanden wie decltype zu bilden. Es erstellt kein Objekt und ermöglicht daher, Operationen auch dann zu untersuchen, wenn T keinen zugänglichen Standardkonstruktor hat.

Der Rückgabetyp ist std::add_rvalue_reference_t<T>. Bei einem Objekttyp T ist der Ausdruck ein xvalue des Typs T; bei T& ist er aufgrund der Referenzkomposition ein lvalue. Daher können std::declval<T>() und std::declval<T&>() unterschiedliche Überladungen auswählen. Bei void ist der Ergebnistyp void, nicht das ungültige void&&.

Die Funktion darf nicht odr-verwendet werden: Ein tatsächlicher ausgewerteter Aufruf ist unzulässig, auch während der Konstantenauswertung. Der Parameter T darf unvollständig sein, aber die untersuchte Operation muss dennoch gültig sein; der Zugriff auf Member kann eine vollständige Definition erfordern.

Das Beispiel unterscheidet die mit & und && qualifizierten Überladungen von read(). Der Konstruktor Sensor() ist gelöscht, und die Funktionen read() sind nur deklariert: Es wird kein Objekt erstellt und kein Aufruf ausgeführt. Die Assertions prüfen die Typen während der Kompilierung; das Programm gibt nichts aus.

Beispiele

#include <type_traits>
#include <utility>

struct Sensor {
    Sensor() = delete;
    int read() &;
    double read() &&;
};

using LvalueResult = decltype(std::declval<Sensor&>().read());
using RvalueResult = decltype(std::declval<Sensor>().read());

static_assert(std::is_same_v<LvalueResult, int>);
static_assert(std::is_same_v<RvalueResult, double>);
static_assert(std::is_same_v<decltype(std::declval<void>()), void>);

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