Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::enable_if i std::enable_if_t — warunkowe udostępnianie typu

std::enable_if udostępnia typ tylko wtedy, gdy warunek kompilacyjny jest prawdziwy. Alias std::enable_if_t upraszcza zapis; w odpowiednim kontekście podstawiania pozwala usuwać kandydatów z rozstrzygania przeciążeń przez SFINAE.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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> z nagłówka <type_traits> jest szablonem klasy. Gdy stały warunek B ma wartość true, składowa type oznacza T; gdy ma wartość false, składowa type nie istnieje. Domyślnym T jest void. Nie jest to instrukcja warunkowa wykonywana podczas działania programu.

std::enable_if_t<B, T> jest aliasem typu typename std::enable_if<B, T>::type, a nie osobną klasą ani wartością logiczną. Przy B == false alias nie oznacza żadnego typu — nie staje się automatycznie void.

Jeśli brak typu powoduje niepowodzenie podstawiania w bezpośrednim kontekście deklaracji szablonu funkcji, działa SFINAE: kandydat odpada zamiast powodować błąd kompilacji całego programu. Nie oznacza to tłumienia dowolnych błędów: użycie std::enable_if_t<false, int> poza takim kontekstem albo błąd w ciele instancjonowanej funkcji może spowodować błąd kompilacji.

W przykładzie zależny typ zwracany dopuszcza szablon classify dla typów całkowitych. Dla 42 wygrywa on z przeciążeniem ...; dla 3.5 podstawianie nie udaje się i pozostaje przeciążenie zapasowe. static_assert sprawdza równoważność obu zapisów dla prawdziwego warunku.

Przykłady

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

Wynik

integral
other

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła