CKTIS / C++
std::invoke: invocação uniforme de callables
std::invoke chama funções, objetos-função e ponteiros para membros numa interface com perfect forwarding.
Versão: C++23
Sintaxe
template<class F, class... Args>
constexpr std::invoke_result_t<F, Args...>
std::invoke(F&& callable, Args&&... args)
noexcept(std::is_nothrow_invocable_v<F, Args...>);std::invoke(f,args...) aplica INVOKE: callable normal recebe argumentos encaminhados; ponteiro para função membro precisa de objeto, ponteiro ou std::reference_wrapper; ponteiro para dado membro produz o membro. Só participa se std::is_invocable_v<F,Args...> for true.
O exemplo chama Counter::add, lê Counter::base e executa lambda, imprimindo 12 7 12. Categorias de valor e const são encaminhadas com std::forward, logo acesso ao dado pode devolver referência.
O resultado é std::invoke_result_t<F,Args...> e o noexcept condicional segue std::is_nothrow_invocable_v; exceções propagam-se. Um recetor de membro incompatível torna std::is_invocable_v falso e deixa o overload std::invoke indisponível. Undefined behavior surge antes no acesso por ponteiro ou referência de outro modo compatível, mas null ou dangling. Objeto e referências têm de viver durante a chamada; std::invoke não adia trabalho nem gere as suas vidas.
Exemplos
#include <functional>
#include <iostream>
struct Counter {
int base;
int add(int value) const { return base + value; }
};
int main() {
const Counter counter{7};
std::cout << std::invoke(&Counter::add, counter, 5) << ' '
<< std::invoke(&Counter::base, counter) << ' '
<< std::invoke([](int a, int b) { return a * b; }, 3, 4) << '\n';
}
Resultado
12 7 12
std::invoke → 12 7 12