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

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

Fontes