CKTIS / C++
std::invoke: jednotné volání callable
std::invoke volá funkce, funkční objekty a ukazatele na členy jedním rozhraním s perfect forwarding.
Verze: C++23
Syntaxe
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...) provádí INVOKE: běžný callable dostane předané argumenty; ukazatel na členskou funkci potřebuje objekt, ukazatel nebo std::reference_wrapper; ukazatel na datový člen vrací člen. Funkce se účastní jen když std::is_invocable_v<F,Args...> je true.
Příklad volá Counter::add, čte Counter::base a spouští lambdu, proto vypíše 12 7 12. Kategorie hodnot a const se zachovají přes std::forward, takže přístup k datu může vrátit referenci.
Typ výsledku je std::invoke_result_t<F,Args...> a podmíněné noexcept odpovídá std::is_nothrow_invocable_v; výjimky se šíří. Nekompatibilní příjemce členu způsobí, že std::is_invocable_v je false a přetížení std::invoke není dostupné. Nedefinované chování naopak vzniká přístupem přes jinak kompatibilní, ale null nebo visící ukazatel či referenci. Objekt a reference musí během volání žít; std::invoke práci neodkládá ani jejich životnost nespravuje.
Pří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ýsledek
12 7 12
std::invoke → 12 7 12