CKTIS / C++
std::function: wrapper de chamada copiável
std::function guarda qualquer chamável copiável compatível com uma assinatura e invoca-o por uma interface uniforme.
Versão: C++23
Sintaxe
template<class Signature> class std::function;
template<class R, class... Args>
class std::function<R(Args...)> {
public:
function() noexcept;
template<class F> function(F&& f);
explicit operator bool() const noexcept;
R operator()(Args... args) const;
};std::function<R(Args...)> de <functional> é um wrapper polimórfico com apagamento de tipo. Pode conter ponteiro de função, functor, binding ou lambda se o tipo guardado for copiável e invocável com Args..., produzindo resultado compatível com R. O wrapper pode ser copiado e movido; a cópia duplica o alvo, portanto capturas por valor pertencem a cada cópia.
O exemplo guarda uma lambda que captura factor por valor em std::function<int(int)>. std::function::operator() invoca o alvo guardado, logo scale(5) devolve 15. std::function::operator bool indica se o wrapper contém um alvo; o segundo é construído por omissão, pelo que static_cast<bool>(empty) é falso e o programa imprime 15 0. Testa o estado booleano antes de invocar um callback opcional, exceto se o vazio for deliberadamente tratado por exceção.
Invocar um wrapper vazio lança std::bad_function_call; exceções do alvo propagam-se. A construção pode alocar e lançar std::bad_alloc ou qualquer exceção da inicialização do alvo, incluindo um movimento que lance a partir de argumento rvalue; a otimização de objeto pequeno não é garantida. Uma lambda apenas movível não satisfaz std::function em C++23: usa std::move_only_function. Capturar por referência não prolonga a vida e pode ficar pendente. target<T>() exige o tipo guardado exato e a assinatura do wrapper não preserva noexcept.
Exemplos
#include <functional>
#include <iostream>
int main() {
const int factor = 3;
std::function<int(int)> scale = [factor](int value) {
return factor * value;
};
std::function<int(int)> empty;
std::cout << scale(5) << ' ' << static_cast<bool>(empty) << '\n';
}
Resultado
15 0
std::function → 15 0