CKTIS / C++
std::declval — zkoumání výrazů bez vytvoření objektu
std::declval z <utility> umožňuje zkoumat typ výrazu bez vytvoření objektu. Používá se v nevyhodnocovaných operandech, například v decltype; nesmí se použít ke skutečnému vyhodnocovanému volání.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <utility>
template<class T>
std::add_rvalue_reference_t<T> std::declval() noexcept;std::declval<T>() z <utility> umožňuje vytvářet výrazy v nevyhodnocovaných operandech, například v decltype. Nevytváří žádný objekt, takže lze zkoumat operace i v případě, že T nemá přístupný výchozí konstruktor.
Návratový typ je std::add_rvalue_reference_t<T>. Pro objektový typ T je výraz xvalue typu T; pro T& je díky slučování referencí lvalue. std::declval<T>() a std::declval<T&>() proto mohou vybrat různé přetížené funkce. Pro void je typ výsledku void, nikoli neplatné void&&.
Funkce nesmí být použita způsobem odr-use: skutečné vyhodnocované volání je zakázáno, a to i během konstantního vyhodnocování. Parametr T může být neúplný, ale zkoumaná operace musí být přesto platná; přístup ke členům může vyžadovat úplnou definici.
Příklad rozlišuje přetížení read() kvalifikovaná pomocí & a &&. Konstruktor Sensor() je odstraněn a funkce read() jsou pouze deklarované: žádný objekt se nevytváří a žádné volání se neprovádí. Aserty ověřují typy při kompilaci; program nic nevypisuje.
Příklady
#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() {}
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.