Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::function: kopiowalny wrapper wywołania

std::function przechowuje dowolny kopiowalny obiekt wywoływalny pasujący do zadanej sygnatury i wywołuje go przez jednolity interfejs.

Wersja: C++23

Składnia

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...)> z <functional> jest polimorficznym wrapperem z wymazywaniem typu. Może zawierać wskaźnik funkcji, funktor, wiązanie lub lambdę, jeżeli zapisany typ jest kopiowalny i można go wywołać z Args..., uzyskując wynik zgodny z R. Sam wrapper można kopiować i przenosić; kopia kopiuje zapisany cel, a przechwycone wartości należą wtedy do każdej kopii celu.

Przykład zapisuje lambdę przechwytującą factor przez wartość w std::function<int(int)>. std::function::operator() wywołuje zapisany cel, więc scale(5) zwraca 15. std::function::operator bool informuje, czy wrapper ma cel; drugi wrapper jest skonstruowany domyślnie, więc static_cast<bool>(empty) jest fałszywe i program drukuje 15 0. Sprawdzenie bool jest obowiązkowe przed wywołaniem opcjonalnego callbacku, chyba że pusty stan ma być obsłużony przez wyjątek.

Wywołanie pustego wrappera zgłasza std::bad_function_call; wyjątki celu są propagowane. Konstrukcja może alokować i zgłosić std::bad_alloc lub dowolny wyjątek inicjalizacji zapisanego celu, w tym rzucającego przeniesienia z argumentu rvalue; optymalizacja małego obiektu nie jest gwarantowana. Lambda tylko do przenoszenia nie spełnia kontraktu std::function w C++23 — do niej służy std::move_only_function. Przechwycenie przez referencję nie przedłuża życia obiektu, więc cel może zawierać wiszącą referencję. target<T>() działa tylko dla dokładnego zapisanego typu, a sygnatura wrappera nie zachowuje kwalifikatora noexcept.

Przykłady

#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';
}

Wynik

15 0

std::function → 15 0

Źródła