functional_unwrap_reference

functional_unwrap_reference (reference_wrapper를 푸는 도구)

이 페이지에서는 std::unwrap_referencestd::unwrap_ref_decay에 대해 설명해요. 이 템플릿들은 std::reference_wrapper를 원래 타입의 참조로 변환해 주는 역할을 해요. C++20부터 사용할 수 있어요.

출처: cppreference

본문

헤더 <type_traits>에 정의됨
헤더 <functional>에 정의됨
template < class T > struct unwrap_reference ; (1) (since C++20)
template < class T > struct unwrap_ref_decay ; (2) (since C++20)

std::reference_wrapper를 풀어서 std::reference_wrapper<U>U&로 바꿔요. 프로그램에서 이 페이지에 설명된 템플릿에 대해 특수화를 추가하면 동작이 정의되지 않아요.

중첩 타입 (Nested types)

타입 정의
type (1) Tstd::reference_wrapper<U>이면 U&, 아니면 T (2) std::decay_t<T>std::reference_wrapper<U>이면 U&, 아니면 std::decay_t<T>

헬퍼 타입 (Helper types)

템플릿
template < class T > using unwrap_reference_t = unwrap_reference < T >:: type ; (1) (since C++20)
template < class T > using unwrap_ref_decay_t = unwrap_ref_decay < T >:: type ; (2) (since C++20)

가능한 구현 (Possible implementation)

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 >> {};

참고 (Notes)

std::unwrap_ref_decaystd::make_pairstd::make_tuple에서 사용하는 것과 동일한 변환을 수행해요.

기능 테스트 매크로 (Feature-test macro)

매크로 표준 기능
__cpp_lib_unwrap_ref 201811L (C++20) std::unwrap_ref_decaystd::unwrap_reference

예제 (Example)

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

static_assert(
    std::is_same_v<std::unwrap_reference_t<int>, int> &&
    std::is_same_v<std::unwrap_reference_t<const int>, const int> &&
    std::is_same_v<std::unwrap_reference_t<int&>, int&> &&
    std::is_same_v<std::unwrap_reference_t<int&&>, int&&> &&
    std::is_same_v<std::unwrap_reference_t<int*>, int*> &&

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

int main()
{    
    {
        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&>);
    }
    
    {
        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; // Error: does not work if T is reference_wrapper<>

            // converts T&& into T& for ordinary types
            // converts T&& into U& for reference_wrapper<U>
            decltype(auto) r = std::unwrap_reference_t<T>(z);
            std::cout << "r: " << r << '\n';
            r = 0; // OK, r has reference type
        };
        
        int x = 1;
        reset(x);
        assert(x == 0);
        
        int y = 2;
        reset(std::ref(y));
        assert(y == 0);
    }
}

출력:

r: 1
r: 2

같이 보기 (See also)

항목 설명
decay (C++11) 함수 인자를 값으로 전달할 때 적용되는 타입 변환을 수행해요 (클래스 템플릿) [edit]
reference_wrapper (C++11) 복사 생성 가능하고 복사 대입 가능한 참조 래퍼예요 (클래스 템플릿) [edit]
make_pair 인자 타입으로 결정되는 pair 객체를 만들어요 (함수 템플릿) [edit]
make_tuple (C++11) 인자 타입으로 결정되는 tuple 객체를 만들어요 (함수 템플릿) [edit]
unwrap_reference unwrap_ref_decay (C++26) (C++26) std::reference_wrapper의 기본 타입에 대한 반영된 참조 타입을 얻어요 (함수) [edit]

더 알아보기 (Learn more)

cppreference