KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::function: kopieerbare aanroepwrapper

std::function bewaart elk kopieerbaar aanroepbaar object dat bij een signatuur past en roept het via één interface aan.

Versie: C++23

Syntax

template<class Signature> class std::function;

template<class R, class... Args>
class std::function<R(Args...)> {
public:
    function() noexcept;
    template<class F> function(F&& f);
    explicit operator bool() const noexcept;
    R operator()(Args... args) const;
};

std::function<R(Args...)> uit <functional> is een polymorfe wrapper met type-erasure. Hij kan een functiepointer, functor, binding of lambda bevatten als het opgeslagen type kopieerbaar is en met Args... een met R verenigbaar resultaat geeft. De wrapper is kopieerbaar en verplaatsbaar; een kopie kopieert het doel, zodat waardecaptures deel worden van elke doelkopie.

Het voorbeeld bewaart een lambda die factor per waarde vangt in std::function<int(int)>. std::function::operator() roept het opgeslagen doel aan, zodat scale(5) de waarde 15 levert. std::function::operator bool meldt of de wrapper een doel bevat; de tweede is standaard geconstrueerd, dus static_cast<bool>(empty) is onwaar en het programma print 15 0. Test de booleaanse toestand vóór het aanroepen van een optionele callback, tenzij afhandeling van leegte via een exceptie bedoeld is.

Een lege wrapper aanroepen werpt std::bad_function_call; excepties uit het doel worden doorgegeven. Constructie kan alloceren en std::bad_alloc of elke exceptie uit doelinitialisatie werpen, waaronder een werpende verplaatsing vanuit een rvalue-argument; small-object-optimalisatie is niet gegarandeerd. Een alleen verplaatsbare lambda voldoet in C++23 niet aan std::function; gebruik std::move_only_function. Referentiecaptures verlengen geen levensduur en kunnen hangen. target<T>() past alleen bij het exacte opgeslagen type en de wrappersignatuur bewaart noexcept niet.

Voorbeelden

#include <functional>
#include <iostream>

int main() {
    const int factor = 3;
    std::function<int(int)> scale = [factor](int value) {
        return factor * value;
    };
    std::function<int(int)> empty;

    std::cout << scale(5) << ' ' << static_cast<bool>(empty) << '\n';
}

Resultaat

15 0

std::function → 15 0

Bronnen