CKTIS / C++
std::invoke: единно извикване на callable
std::invoke извиква функции, функционални обекти и указатели към членове чрез един perfect-forwarding интерфейс.
Версия: C++23
Синтаксис
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...) изпълнява INVOKE: обикновен callable получава препратените аргументи; указател към член-функция иска обект, указател или std::reference_wrapper; указател към поле връща полето. Функцията участва само ако std::is_invocable_v<F,Args...> е true.
Примерът извиква Counter::add, чете Counter::base и изпълнява lambda, затова извежда 12 7 12. Категориите и const се пазят чрез std::forward, следователно достъпът до поле може да върне референция.
Резултатът е std::invoke_result_t<F,Args...>, а условното noexcept следва std::is_nothrow_invocable_v; изключенията се разпространяват. Несъвместим получател на член прави std::is_invocable_v false и overload-ът на std::invoke не е наличен. Undefined behavior възниква при достъп през иначе съвместим, но null или висящ указател или референция. Обектът и референциите трябва да живеят по време на извикването; std::invoke не отлага работа и не управлява lifetime им.
Примери
#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';
}
Резултат
12 7 12
std::invoke → 12 7 12