WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::enable_if und std::enable_if_t — einen Typ bedingt bereitstellen

std::enable_if stellt einen Typ nur dann bereit, wenn eine Bedingung zur Compilezeit wahr ist. Der Alias std::enable_if_t verkürzt die Schreibweise und kann in einem geeigneten Substitutionskontext mithilfe von SFINAE Kandidaten aus der Überladungsauflösung entfernen.

Version: 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> aus <type_traits> ist ein Klassentemplate. Ist die konstante Bedingung B true, bezeichnet sein Element type den Typ T; ist sie false, gibt es kein Element type. Der Standardwert für T ist void. Dies ist keine bedingte Anweisung, die zur Laufzeit ausgeführt wird.

std::enable_if_t<B, T> ist ein Alias für den Typ typename std::enable_if<B, T>::type, keine eigenständige Klasse und kein boolescher Wert. Bei B == false bezeichnet der Alias keinen Typ — er wird nicht automatisch zu void.

Führt der fehlende Typ im unmittelbaren Kontext einer Funktions-Template-Deklaration zu einem Substitutionsfehler, greift SFINAE: Der Kandidat wird entfernt, statt dass die Kompilierung des gesamten Programms fehlschlägt. Beliebige Fehler werden dadurch nicht unterdrückt: Die Verwendung von std::enable_if_t<false, int> außerhalb eines solchen Kontexts oder ein Fehler im Rumpf einer instanziierten Funktion kann einen Kompilierungsfehler verursachen.

Im Beispiel ermöglicht der abhängige Rückgabetyp das Template classify für integrale Typen. Für 42 gewinnt es gegenüber der Überladung ...; für 3.5 schlägt die Substitution fehl und die Ersatzüberladung bleibt übrig. static_assert prüft, dass beide Schreibweisen bei einer wahren Bedingung denselben Typ bezeichnen.

Beispiele

#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';
}

Ergebnis

integral
other

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen