close
Пространства имён
Варианты
Действия

std::unwrap_reference, std::unwrap_ref_decay

Материал из cppreference.com
 
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
Трёхстороннее сравнение (C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
Общие утилиты
Дата и время
Функциональные объекты
Библиотека форматирования (C++20)
(C++11)
Операторы отношения (устарело в C++20)
Целочисленные функции сравнения
(C++20)(C++20)(C++20)    
(C++20)
Операции обмена и типа
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
 
Объекты функции
Функции обёртки
(C++11)
(C++11)
Применение частичных функций
(C++20)(C++23)
(C++11)
Вызов функции
(C++17)(C++23)
Объект идентичности функции
(C++20)
Обёртки ссылок
(C++11)(C++11)
Прозрачные обёртки операторов
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

Отрицатели
(C++17)
Искатели
Ограниченные компараторы
Старые привязки и адаптеры
(до C++17*)
(до C++17*)
(до C++17*)
(до C++17*)
(до C++17*)(до C++17*)(до C++17*)(до C++17*)
(до C++20*)
(до C++20*)
(до C++17*)(до C++17*)
(до C++17*)(до C++17*)

(до C++17*)
(до C++17*)(до C++17*)(до C++17*)(до C++17*)
(до C++20*)
(до C++20*)
 
<tbody> </tbody>
Определено в заголовочном файле <type_traits>
Определено в заголовочном файле <functional>
template< class T > struct unwrap_reference;
(1) (начиная с C++20)
template< class T > struct unwrap_ref_decay;
(2) (начиная с C++20)
1) Если T является std::reference_wrapper<U> для некоторого типа U, предоставляет псевдоним типа элемента type, который именуется U&; иначе предоставляет псевдоним типа элемента type с именем T.
2) Если T является std::reference_wrapper<U> для некоторого типа U, игнорируя cv-квалификацию и ссылочную принадлежность, предоставляет псевдоним типа элемента type с именем U&; иначе предоставляет псевдоним типа элемента type с именем std::decay_t<T>.

Поведение программы, добавляющей специализации для любых шаблонов, описанных на этой странице не определено.

Типы элементы

Имя Определение
type

(1) U&, если T равно std::reference_wrapper<U>; T иначе
(2) U&, если std::decay_t<T> равно std::reference_wrapper<U>; std::decay_t<T> иначе

Вспомогательные типы

<tbody> </tbody>
template<class T> using unwrap_reference_t = typename unwrap_reference<T>::type;
(1) (начиная с C++20)
template<class T> using unwrap_ref_decay_t = typename unwrap_ref_decay<T>::type;
(2) (начиная с C++20)

Возможная реализация

template <class T>
struct unwrap_reference { using type = T; };
template <class U>
struct unwrap_reference<std::reference_wrapper<U>> { using type = U&; };

template< class T >
struct unwrap_ref_decay : std::unwrap_reference<std::decay_t<T>> {};

Примечание

std::unwrap_ref_decay выполняет то же преобразование, что и std::make_pair и std::make_tuple.

Макрос Тестирования функциональности Значение Стандарт Функциональность
__cpp_lib_unwrap_ref 201811L (C++20) std::unwrap_ref_decay и std::unwrap_reference

Пример

#include <cassert>
#include <functional>
#include <iostream>
#include <type_traits>

int main()
{
    static_assert(std::is_same_v<std::unwrap_reference_t<int>, int>);
    static_assert(std::is_same_v<std::unwrap_reference_t<const int>, const int>);
    static_assert(std::is_same_v<std::unwrap_reference_t<int&>, int&>);
    static_assert(std::is_same_v<std::unwrap_reference_t<int&&>, int&&>);
    static_assert(std::is_same_v<std::unwrap_reference_t<int*>, int*>);

    {
        using T = std::reference_wrapper<int>;
        using X = std::unwrap_reference_t<T>;
        static_assert(std::is_same_v<X, int&>);
    }
    {
        using T = std::reference_wrapper<int&>;
        using X = std::unwrap_reference_t<T>;
        static_assert(std::is_same_v<X, int&>);
    }

    static_assert(std::is_same_v<std::unwrap_ref_decay_t<int>, int>);
    static_assert(std::is_same_v<std::unwrap_ref_decay_t<const int>, int>);
    static_assert(std::is_same_v<std::unwrap_ref_decay_t<const int&>, int>);

    {
        using T = std::reference_wrapper<int&&>;
        using X = std::unwrap_ref_decay_t<T>;
        static_assert(std::is_same_v<X, int&>);
    }

    {
        auto reset = []<typename T>(T&& z)
        {
            // x = 0; // Ошибка: не работает, если T является reference_wrapper<>
            // преобразует T&& в T& для обычных типов
            // преобразует T&& в U& для reference_wrapper<U>
            decltype(auto) r = std::unwrap_reference_t<T>(z);
            std::cout << "r: " << r << '\n';
            r = 0; // OK, r имеет ссылочный тип
        };

        int x = 1;
        reset(x);
        assert(x == 0);

        int y = 2;
        reset(std::ref(y));
        assert(y == 0);
    }
}

Вывод:

r: 1
r: 2

Смотрите также

обёртка ссылок CopyConstructible и CopyAssignable
(шаблон класса) [править]
создаёт объект типа pair, определённого типами аргументов
(шаблон функции) [править]
создаёт объект tuple типа, определённого типами аргументов
(шаблон функции) [править]