Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::enable_if a std::enable_if_t — podmíněné zpřístupnění typu

std::enable_if zpřístupní typ pouze tehdy, když je podmínka vyhodnocená při kompilaci pravdivá. Alias std::enable_if_t zkracuje zápis a ve vhodném kontextu substituce umožňuje SFINAE odstranit kandidáty z rozlišení přetížení.

Verze: 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> z hlavičky <type_traits> je šablona třídy. Pokud je konstantní podmínka B true, její člen type označuje typ T; pokud je false, člen type neexistuje. Výchozí hodnota T je void. Nejde o podmíněný příkaz vykonávaný za běhu programu.

std::enable_if_t<B, T> je alias typu typename std::enable_if<B, T>::type, nikoli samostatná třída ani logická hodnota. Při B == false alias neoznačuje žádný typ — automaticky se nezmění na void.

Pokud chybějící typ způsobí selhání substituce v bezprostředním kontextu deklarace šablony funkce, uplatní se SFINAE: kandidát se odstraní, místo aby selhala kompilace celého programu. Neznamená to potlačení libovolných chyb: použití std::enable_if_t<false, int> mimo takový kontext nebo chyba v těle instancované funkce může způsobit chybu kompilace.

V příkladu závislý návratový typ povolí šablonu classify pro celočíselné typy. Pro 42 zvítězí nad přetížením ...; pro 3.5 substituce selže a zůstane záložní přetížení. static_assert ověřuje, že oba zápisy při pravdivé podmínce označují stejný typ.

Příklady

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

Výsledek

integral
other

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje