CKTIS / C++
std::invoke: jednotné volanie callable
std::invoke volá funkcie, funkčné objekty a ukazovatele na členy jedným rozhraním s perfect forwarding.
Verzia: C++23
Syntax
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...) vykonáva INVOKE: bežný callable dostane odovzdané argumenty; ukazovateľ na členskú funkciu potrebuje objekt, ukazovateľ alebo std::reference_wrapper; ukazovateľ na dátový člen vracia člen. Funkcia sa zúčastní len keď std::is_invocable_v<F,Args...> je true.
Príklad volá Counter::add, číta Counter::base a spúšťa lambdu, preto vypíše 12 7 12. Kategórie hodnôt a const sa zachovajú cez std::forward, takže prístup k dátam môže vrátiť referenciu.
Typ výsledku je std::invoke_result_t<F,Args...> a podmienené noexcept zodpovedá std::is_nothrow_invocable_v; výnimky sa šíria. Nekompatibilný prijímateľ člena spôsobí, že std::is_invocable_v je false a preťaženie std::invoke nie je dostupné. Nedefinované správanie naopak vzniká prístupom cez inak kompatibilný, ale null alebo visiaci ukazovateľ či referenciu. Objekt a referencie musia počas volania žiť; std::invoke prácu neodkladá ani ich životnosť nespravuje.
Príklady
#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';
}
Výsledok
12 7 12
std::invoke → 12 7 12