CKTIS / C++
std::invoke: einheitlicher Callable-Aufruf
std::invoke ruft Funktionen, Funktionsobjekte und Memberzeiger über eine Perfect-Forwarding-Schnittstelle auf.
Version: 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...) implementiert INVOKE: Ein gewöhnliches Callable erhält weitergeleitete Argumente; ein Memberfunktionszeiger braucht Objekt, Zeiger oder std::reference_wrapper; ein Datenmemberzeiger liefert das Member. Die Funktion ist nur verfügbar, wenn std::is_invocable_v<F,Args...> true ist.
Das Beispiel ruft Counter::add auf, liest Counter::base und ruft ein Lambda; Ausgabe ist 12 7 12. Wertkategorien und Constheit werden über std::forward erhalten, daher kann Memberzugriff eine Referenz liefern.
Ergebnistyp ist std::invoke_result_t<F,Args...>, bedingtes noexcept entspricht std::is_nothrow_invocable_v; Callable-Ausnahmen werden weitergereicht. Ein inkompatibler Member-Empfänger macht std::is_invocable_v falsch und die std::invoke-Überladung unverfügbar. Undefiniert ist dagegen der Zugriff über einen sonst kompatiblen, aber nullen oder hängenden Zeiger beziehungsweise eine solche Referenz. Objekt und Referenzen müssen den Aufruf überleben; std::invoke verzögert nichts und verwaltet ihre Lebensdauer nicht.
Beispiele
#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';
}
Ergebnis
12 7 12
std::invoke → 12 7 12