Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::void_t — detetar tipos válidos

std::void_t, de <type_traits>, associa qualquer pacote válido de argumentos de tipo a void. Em conjunto com SFINAE, permite detetar se um tipo aninhado está disponível sem tornar o programa inteiro mal formado.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

template<class...> using void_t = void; // namespace std; header <type_traits>

std::void_t é um modelo de alias declarado em <type_traits>. Para qualquer número de argumentos de tipo válidos, designa void: tanto std::void_t<> como std::void_t<int, double> são o mesmo tipo. Não é uma função nem um trait de valor booleano; não disponibiliza membros próprios ::type ou ::value.

A sua utilidade decorre da substituição de argumentos de modelos. No exemplo, typename T::value_type tem de designar um tipo. Se o fizer, std::void_t<typename T::value_type> produz void, pelo que a especialização parcial de has_value_type corresponde e herda de std::true_type. Caso contrário, a substituição falha no contexto imediato, SFINAE descarta essa especialização e o modelo principal fornece std::false_type.

std::void_t aceita tipos, não expressões arbitrárias. Para testar uma expressão, pode fornecer-se o respetivo tipo através de decltype(...). Esta técnica verifica a validade sintática e dos tipos, não os resultados calculados nem o comportamento em tempo de execução. Não suprime todos os erros: uma utilização inválida fora de um contexto SFINAE e erros causados por instanciação incidental podem continuar a impedir a compilação.

Exemplos

#include <iostream>
#include <type_traits>

template<class T, class = void>
struct has_value_type : std::false_type {};

template<class T>
struct has_value_type<T, std::void_t<typename T::value_type>>
    : std::true_type {};

struct Item {
    using value_type = int;
};

static_assert(std::is_same_v<std::void_t<>, void>);
static_assert(std::is_same_v<std::void_t<int, double>, void>);
static_assert(has_value_type<Item>::value);
static_assert(!has_value_type<int>::value);

int main() {
    std::cout << std::boolalpha
              << has_value_type<Item>::value << '\n'
              << has_value_type<int>::value << '\n';
}

Resultado

true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes