CKTIS / C++
std::invoke: uniforme callable-aanroep
std::invoke roept functies, functieobjecten en memberpointers aan via één perfect-forwardinginterface.
Versie: 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...) implementeert INVOKE: een gewone callable ontvangt doorgestuurde argumenten; een memberfunctiepointer vereist object, pointer of std::reference_wrapper; een datamemberpointer levert het member. De functie doet alleen mee als std::is_invocable_v<F,Args...> true is.
Het voorbeeld roept Counter::add aan, leest Counter::base en roept een lambda aan, dus print 12 7 12. Waardecategorieën en const worden via std::forward behouden, zodat datatoegang een referentie kan retourneren.
Het resultaattype is std::invoke_result_t<F,Args...> en conditionele noexcept volgt std::is_nothrow_invocable_v; excepties worden doorgegeven. Een incompatibele member-ontvanger maakt std::is_invocable_v onwaar en de std::invoke-overload niet beschikbaar. Ongedefinieerd gedrag ontstaat bij toegang via een verder compatibele maar null of dangling pointer of referentie. Object en referenties moeten tijdens de aanroep leven; std::invoke stelt niets uit en beheert hun levensduur niet.
Voorbeelden
#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';
}
Resultaat
12 7 12
std::invoke → 12 7 12