Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła