# std::void_t

< cpp‎ | types

定义于头文件 `<type_traits>` |  |
template< class... > using void_t = void; |  | (C++17 起)

将任意类型的序列映射到类型 void 的工具元函数。

### 注解

模板元编程中，用此元函数检测 SFINAE 语境中的非良构类型：

    // 主模板处理无嵌套 ::type 成员的类型：
    template< class, class = void >
    struct has_type_member : std::false_type { };

    // 特化识别拥有嵌套 ::type 成员的类型：
    template< class T >
    struct has_type_member<T, std::void_t<typename T::type>> : std::true_type { };

它亦可用于检测表达式的合法性：

    // 主模板处理不支持前置自增的类型：
    template< class, class = void >
    struct has_pre_increment_member : std::false_type { };
    // 特化识别支持前置自增的类型：
    template< class T >
    struct has_pre_increment_member<T,
               std::void_t<decltype( ++std::declval<T&>() )>
           > : std::true_type { };

直至 CWG 1558 （ C++11 缺陷）前，别名模板中未使用的参数不保证 SFINAE 且可被忽略，故早期编译器要求 `void_t` 的更复杂定义，例如：

    template<typename... Ts> struct make_void { typedef void type;};
    template<typename... Ts> using void_t = typename make_void<Ts...>::type;

### 示例

    #include <iostream>
    #include <type_traits>
    #include <vector>
    #include <map>

    class A {};

    template <typename T, typename = void>
    struct is_iterable : std::false_type {};
    template <typename T>
    struct is_iterable<T, std::void_t<decltype(std::declval<T>().begin()),
                                      decltype(std::declval<T>().end())>>
        : std::true_type {};

    // 迭代器特性，其 value_type 始终为被迭代容器的 value_type ，
    // 即使用 value_type 为 void 的 back_insert_iterator

    template <typename T, typename = void>
    struct iterator_trait
    : std::iterator_traits<T> {};
    template <typename T>
    struct iterator_trait<T, std::void_t<typename T::container_type>>
    : std::iterator_traits<typename T::container_type::iterator> {};

    int main()
    {
        std::cout << std::boolalpha;
        std::cout << is_iterable<std::vector<double>>::value << '\n';
        std::cout << is_iterable<std::map<int, double>>::value << '\n';
        std::cout << is_iterable<double>::value << '\n';
        std::cout << is_iterable<A>::value << '\n';

        std::vector<int> v;

        std::cout << std::is_same<iterator_trait<decltype(std::back_inserter(v))>::value_type
        , iterator_trait<decltype(v.cbegin())>::value_type >::value << '\n';
    }

输出：

    true
    true
    false
    false
    true

### 参阅

enable_if (C++11) | 条件性地从重载决议移除函数重载或模板特化 (类模板)