CKTIS / C++
std::declval — badanie wyrażeń bez tworzenia obiektu
std::declval z nagłówka <utility> pozwala badać typ wyrażenia bez konstruowania obiektu. Stosuje się je w operandach nieewaluowanych, np. w decltype; nie wolno używać go do rzeczywistego wywołania.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <utility>
template<class T>
std::add_rvalue_reference_t<T> std::declval() noexcept;std::declval<T>() z nagłówka <utility> służy do budowania wyrażeń w operandach nieewaluowanych, np. w decltype. Nie tworzy obiektu, więc umożliwia badanie operacji także wtedy, gdy T nie ma dostępnego konstruktora domyślnego.
Typ zwracany to std::add_rvalue_reference_t<T>. Dla typu obiektowego T wyrażenie jest xvalue typu T; dla T& jest lvalue dzięki składaniu referencji. Dlatego std::declval<T>() i std::declval<T&>() mogą wybierać różne przeciążenia. Dla void typem wyniku jest void, a nie niepoprawne void&&.
Funkcja nie może być odr-użyta: rzeczywiste wywołanie jest niedozwolone, również podczas obliczania stałej. Parametr T może być typem niekompletnym, ale badana operacja nadal musi być poprawna; dostęp do składowych może wymagać kompletnej definicji.
Przykład rozróżnia przeciążenia read() z kwalifikatorami & i &&. Konstruktor Sensor() jest usunięty, a funkcje read() mają tylko deklaracje: żaden obiekt nie powstaje i żadne wywołanie nie jest wykonywane. Asercje sprawdzają typy podczas kompilacji; program niczego nie wypisuje.
Przykłady
#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() {}
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.