WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen