Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::declval — esaminare le espressioni senza costruire un oggetto

std::declval di <utility> permette di esaminare il tipo di un’espressione senza costruire un oggetto. Si usa in operandi non valutati, come decltype; non deve essere usato per una chiamata effettiva valutata.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <utility>

template<class T>
std::add_rvalue_reference_t<T> std::declval() noexcept;

std::declval<T>() di <utility> permette di formare espressioni in operandi non valutati, come decltype. Non costruisce alcun oggetto, quindi consente di esaminare operazioni anche quando T non ha un costruttore predefinito accessibile.

Il tipo restituito è std::add_rvalue_reference_t<T>. Per un tipo oggetto T, l’espressione è un xvalue di tipo T; per T&, è un lvalue a causa del collasso dei riferimenti. Di conseguenza, std::declval<T>() e std::declval<T&>() possono selezionare overload diversi. Per void, il tipo del risultato è void, non l’invalido void&&.

La funzione non deve essere usata in modo odr-use: una chiamata effettiva valutata è vietata, anche durante la valutazione costante. Il parametro T può essere incompleto, ma l’operazione esaminata deve comunque essere valida; l’accesso ai membri può richiedere una definizione completa.

L’esempio distingue gli overload di read() qualificati con & e &&. Il costruttore Sensor() è eliminato e le funzioni read() sono solo dichiarate: non viene costruito alcun oggetto e non viene eseguita alcuna chiamata. Le asserzioni verificano i tipi durante la compilazione; il programma non stampa nulla.

Esempi

#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() {}

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti