CKTIS / C++
std::enable_if en std::enable_if_t — een type voorwaardelijk beschikbaar maken
std::enable_if stelt een type alleen beschikbaar als een compile-timevoorwaarde waar is. De alias std::enable_if_t verkort de schrijfwijze en laat SFINAE in een geschikte substitutiecontext kandidaten uit de overloadresolutie verwijderen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#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> uit <type_traits> is een klassentemplate. Als de constante voorwaarde B true is, duidt het lid type het type T aan; als de voorwaarde false is, bestaat het lid type niet. De standaardwaarde voor T is void. Dit is geen voorwaardelijke instructie die tijdens de uitvoering van het programma wordt uitgevoerd.
std::enable_if_t<B, T> is een alias voor het type typename std::enable_if<B, T>::type, geen aparte klasse of booleaanse waarde. Bij B == false duidt de alias geen type aan — hij wordt niet automatisch void.
Als het ontbrekende type in de onmiddellijke context van een functietemplatedeclaratie een substitutiefout veroorzaakt, is SFINAE van toepassing: de kandidaat wordt verwijderd in plaats van dat de compilatie van het hele programma mislukt. Dit onderdrukt geen willekeurige fouten: het gebruik van std::enable_if_t<false, int> buiten zo’n context, of een fout in de body van een geïnstantieerde functie, kan een compilatiefout veroorzaken.
In het voorbeeld maakt het afhankelijke retourtype de template classify beschikbaar voor integrale typen. Voor 42 wint deze van de overload ...; voor 3.5 mislukt de substitutie en blijft de terugvaloverload over. static_assert controleert dat beide schrijfwijzen bij een ware voorwaarde hetzelfde type aanduiden.
Voorbeelden
#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';
}
Resultaat
integral other
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.