Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::declval — examiner des expressions sans construire d’objet

std::declval de <utility> permet d’examiner le type d’une expression sans construire d’objet. Utilisez-le dans des opérandes non évalués, comme decltype ; il ne doit pas servir à un véritable appel évalué.

Version : 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>() de <utility> permet de former des expressions dans des opérandes non évalués, comme decltype. Il ne construit aucun objet : on peut donc examiner des opérations même si T ne possède pas de constructeur par défaut accessible.

Son type de retour est std::add_rvalue_reference_t<T>. Pour un type objet T, l’expression est une xvalue de type T ; pour T&, c’est une lvalue en raison de la fusion des références. Ainsi, std::declval<T>() et std::declval<T&>() peuvent sélectionner des surcharges différentes. Pour void, le type du résultat est void, et non l’invalide void&&.

La fonction ne doit pas être utilisée au sens ODR : un véritable appel évalué est interdit, y compris pendant l’évaluation constante. Le paramètre T peut être incomplet, mais l’opération examinée doit tout de même être valide ; l’accès aux membres peut nécessiter une définition complète.

L’exemple distingue les surcharges de read() qualifiées par & et &&. Le constructeur Sensor() est supprimé, et les fonctions read() sont seulement déclarées : aucun objet n’est construit et aucun appel n’est exécuté. Les assertions vérifient les types à la compilation ; le programme n’affiche rien.

Exemples

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources