Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::enable_if e std::enable_if_t — esporre un tipo in modo condizionale

std::enable_if espone un tipo solo quando una condizione valutata in compilazione è vera. L’alias std::enable_if_t abbrevia la scrittura e, in un contesto di sostituzione appropriato, consente a SFINAE di rimuovere candidati dalla risoluzione degli overload.

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

Sintassi

#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> di <type_traits> è un template di classe. Quando la condizione costante B è true, il suo membro type denota T; quando è false, il membro type non esiste. Il valore predefinito di T è void. Non è un’istruzione condizionale eseguita durante l’esecuzione del programma.

std::enable_if_t<B, T> è un alias del tipo typename std::enable_if<B, T>::type, non una classe distinta né un valore booleano. Con B == false, l’alias non denota alcun tipo: non diventa automaticamente void.

Se l’assenza del tipo causa un errore di sostituzione nel contesto immediato della dichiarazione di un template di funzione, si applica SFINAE: il candidato viene rimosso invece di far fallire la compilazione dell’intero programma. Questo non sopprime errori arbitrari: usare std::enable_if_t<false, int> al di fuori di tale contesto, oppure un errore nel corpo di una funzione istanziata, può causare un errore di compilazione.

Nell’esempio, il tipo di ritorno dipendente abilita il template classify per i tipi integrali. Per 42 prevale sull’overload ...; per 3.5 la sostituzione non riesce e rimane l’overload di riserva. static_assert verifica che, con una condizione vera, entrambe le scritture denotino lo stesso tipo.

Esempi

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

Risultato

integral
other

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti