KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen