CKTIS / C++
std::declval — examinar expressões sem construir um objeto
std::declval de <utility> permite examinar o tipo de uma expressão sem construir um objeto. Use-o em operandos não avaliados, como decltype; não deve ser usado para uma chamada real avaliada.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <utility>
template<class T>
std::add_rvalue_reference_t<T> std::declval() noexcept;std::declval<T>() de <utility> permite formar expressões em operandos não avaliados, como decltype. Não constrói nenhum objeto, pelo que permite examinar operações mesmo quando T não tem um construtor predefinido acessível.
O tipo devolvido é std::add_rvalue_reference_t<T>. Para um tipo de objeto T, a expressão é um xvalue do tipo T; para T&, é um lvalue devido ao colapso de referências. Por isso, std::declval<T>() e std::declval<T&>() podem selecionar sobrecargas diferentes. Para void, o tipo do resultado é void, não o inválido void&&.
A função não pode ser usada de forma odr-use: uma chamada real avaliada é proibida, incluindo durante a avaliação constante. O parâmetro T pode ser incompleto, mas a operação examinada tem de continuar a ser válida; o acesso a membros pode exigir uma definição completa.
O exemplo distingue as sobrecargas de read() qualificadas com & e &&. O construtor Sensor() está eliminado e as funções read() estão apenas declaradas: não é construído nenhum objeto nem é executada qualquer chamada. As asserções verificam os tipos durante a compilação; o programa não escreve nada na consola.
Exemplos
#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() {}
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.