Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes