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