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

CKTIS / C++

std::enable_if e std::enable_if_t — expor um tipo condicionalmente

std::enable_if expõe um tipo apenas quando uma condição em tempo de compilação é verdadeira. O alias std::enable_if_t simplifica a escrita e, num contexto de substituição adequado, permite que SFINAE remova candidatos da resolução de sobrecargas.

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

Sintaxe

#include <type_traits>

template<bool B, class T = void> struct enable_if;
template<bool B, class T = void>
using enable_if_t = typename enable_if<B, T>::type;

// Usage:
// typename std::enable_if<condition, Result>::type
// std::enable_if_t<condition, Result>

std::enable_if<B, T> de <type_traits> é um modelo de classe. Quando a condição constante B é true, o seu membro type designa T; quando é false, o membro type não existe. O valor predefinido de T é void. Não se trata de uma instrução condicional executada durante a execução do programa.

std::enable_if_t<B, T> é um alias para o tipo typename std::enable_if<B, T>::type, não uma classe distinta nem um valor booleano. Com B == false, o alias não designa qualquer tipo — não se torna automaticamente void.

Se a ausência do tipo causar uma falha de substituição no contexto imediato da declaração de um modelo de função, aplica-se SFINAE: o candidato é removido, em vez de a compilação de todo o programa falhar. Isto não suprime erros arbitrários: usar std::enable_if_t<false, int> fora desse contexto, ou ocorrer um erro no corpo de uma função instanciada, pode causar um erro de compilação.

No exemplo, o tipo de retorno dependente permite que o modelo classify se aplique a tipos integrais. Para 42, prevalece sobre a sobrecarga ...; para 3.5, a substituição falha e fica disponível a sobrecarga alternativa. static_assert verifica que ambas as escritas designam o mesmo tipo quando a condição é verdadeira.

Exemplos

#include <iostream>
#include <type_traits>

template<class T>
constexpr std::enable_if_t<std::is_integral_v<T>, const char*>
classify(T) {
    return "integral";
}

constexpr const char* classify(...) {
    return "other";
}

static_assert(std::is_same_v<
    typename std::enable_if<true, int>::type,
    std::enable_if_t<true, int>>);

int main() {
    std::cout << classify(42) << '\n';
    std::cout << classify(3.5) << '\n';
}

Resultado

integral
other

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