CKTIS / C++
std::declval — изследване на изрази без създаване на обект
std::declval от <utility> позволява да се изследва типът на израз, без да се създава обект. Използва се в неоценявани операнди, например в decltype; не бива да се използва за действително оценявано извикване.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <utility>
template<class T>
std::add_rvalue_reference_t<T> std::declval() noexcept;std::declval<T>() от <utility> позволява съставянето на изрази в неоценявани операнди, например в decltype. То не създава обект, затова могат да се изследват операции дори когато T няма достъпен конструктор по подразбиране.
Връщаният тип е std::add_rvalue_reference_t<T>. За обектен тип T изразът е xvalue от тип T; за T& е lvalue поради сливането на референции. Затова std::declval<T>() и std::declval<T&>() могат да изберат различни претоварвания. За void типът на резултата е void, а не невалидното void&&.
Функцията не бива да се използва по начин, който изисква дефиниция (odr-use): действително оценявано извикване е забранено, включително по време на константно изчисляване. Параметърът T може да е непълен тип, но изследваната операция все пак трябва да е валидна; достъпът до членове може да изисква пълна дефиниция.
Примерът разграничава претоварванията на read(), квалифицирани с & и &&. Конструкторът Sensor() е изтрит, а функциите read() са само декларирани: не се създава обект и не се изпълнява извикване. Асерциите проверяват типовете по време на компилация; програмата не извежда нищо.
Примери
#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() {}
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.