Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

SFINAE — falha de substituição ou erro de compilação

SFINAE permite descartar uma sobrecarga de template quando a substituição dos argumentos produz um tipo ou uma expressão inválidos no contexto imediato. Não oculta erros arbitrários em templates.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

template<class T>
auto probe(const T& x) -> decltype(x.size(), bool{});
bool probe(...);

SFINAE significa «Substitution Failure Is Not An Error». Quando a substituição dos argumentos de um template falha no contexto imediato, a especialização da função não é adicionada ao conjunto de candidatos da resolução de sobrecargas. Se não restar nenhum candidato adequado, a chamada continua a ser inválida.

No exemplo, decltype(x.size(), bool{}) verifica se x.size() é válido sem o avaliar e produz o tipo bool. Para Sized, é selecionado o template; para int, a substituição falha e é selecionado probe(...).

Este limite é importante: os erros no corpo de uma função ou num template instanciado separadamente não são protegidos por SFINAE. Limitar-se a deslocar uma verificação para o corpo da função não permite descartar uma sobrecarga de forma segura.

Exemplos

#include <iostream>

struct Sized {
    int size() const { return 3; }
};

template<class T>
auto probe(const T& x) -> decltype(x.size(), bool{}) {
    return true;
}

bool probe(...) {
    return false;
}

int main() {
    std::cout << std::boolalpha;
    std::cout << probe(Sized{}) << '\n';
    std::cout << probe(42) << '\n';
}

Resultado

true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes