CKTIS / C++
std::enable_if et std::enable_if_t — exposer un type sous condition
std::enable_if expose un type uniquement si une condition évaluée à la compilation est vraie. L’alias std::enable_if_t abrège l’écriture et, dans un contexte de substitution approprié, permet à SFINAE d’écarter des candidats de la résolution des surcharges.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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> est un modèle de classe. Lorsque la condition constante B vaut true, son membre type désigne T ; lorsqu’elle vaut false, le membre type n’existe pas. La valeur par défaut de T est void. Il ne s’agit pas d’une instruction conditionnelle exécutée à l’exécution du programme.
std::enable_if_t<B, T> est un alias du type typename std::enable_if<B, T>::type, et non une classe distincte ni une valeur booléenne. Avec B == false, l’alias ne désigne aucun type — il ne devient pas automatiquement void.
Si l’absence du type entraîne un échec de substitution dans le contexte immédiat de la déclaration d’un modèle de fonction, SFINAE s’applique : le candidat est écarté au lieu de faire échouer la compilation de tout le programme. Cela ne supprime pas les erreurs quelconques : utiliser std::enable_if_t<false, int> hors d’un tel contexte, ou rencontrer une erreur dans le corps d’une fonction instanciée, peut provoquer une erreur de compilation.
Dans l’exemple, le type de retour dépendant permet au modèle classify de s’appliquer aux types intégraux. Pour 42, il l’emporte sur la surcharge ... ; pour 3.5, la substitution échoue et la surcharge de secours reste disponible. static_assert vérifie que les deux écritures désignent le même type lorsque la condition est vraie.
Exemples
#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';
}
Résultat
integral other
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.