CKTIS / C++
std::invoke: jedinstveno pozivanje callablea
std::invoke poziva funkcije, funkcijske objekte i pokazivače na članove kroz jedno perfect-forwarding sučelje.
Verzija: C++23
Sintaksa
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...) provodi INVOKE: običan callable prima proslijeđene argumente; pokazivač na člansku funkciju treba objekt, pokazivač ili std::reference_wrapper; pokazivač na podatkovni član daje član. Funkcija sudjeluje samo ako je std::is_invocable_v<F,Args...> true.
Primjer poziva Counter::add, čita Counter::base i pokreće lambdu, pa ispisuje 12 7 12. Kategorije vrijednosti i const čuvaju se kroz std::forward, stoga pristup podatku može vratiti referencu.
Rezultat je std::invoke_result_t<F,Args...>, a uvjetni noexcept slijedi std::is_nothrow_invocable_v; iznimke se propagiraju. Nekompatibilan primatelj člana čini std::is_invocable_v false i preopterećenje std::invoke nije dostupno. Nedefinirano ponašanje nastaje pristupom preko inače kompatibilnog, ali null ili visećeg pokazivača odnosno reference. Objekt i reference moraju živjeti tijekom poziva; std::invoke ne odgađa rad niti upravlja njihovim životnim vijekom.
Primjeri
#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';
}
Rezultat
12 7 12
std::invoke → 12 7 12