Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje