CKTIS / C++
std::function: wrapper di chiamata copiabile
std::function memorizza qualsiasi callable copiabile compatibile con una firma e lo invoca tramite un’interfaccia uniforme.
Versione: C++23
Sintassi
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...)> di <functional> è un wrapper polimorfo con cancellazione del tipo. Può contenere puntatore a funzione, funtore, binding o lambda se il tipo memorizzato è copiabile e invocabile con Args... producendo un risultato compatibile con R. Il wrapper è copiabile e spostabile; copiarlo copia il target, quindi le catture per valore appartengono a ogni copia.
L’esempio memorizza una lambda che cattura factor per valore in std::function<int(int)>. std::function::operator() invoca il target memorizzato, quindi scale(5) restituisce 15. std::function::operator bool segnala se il wrapper contiene un target; il secondo è costruito di default, quindi static_cast<bool>(empty) è falso e il programma stampa 15 0. Controlla lo stato booleano prima di invocare un callback opzionale, salvo voler gestire il vuoto mediante eccezione.
Invocare un wrapper vuoto lancia std::bad_function_call; le eccezioni del target si propagano. La costruzione può allocare e lanciare std::bad_alloc o qualsiasi eccezione dell’inizializzazione del target, incluso uno spostamento che lancia da un argomento rvalue; la small-object optimization non è garantita. Una lambda solo spostabile non soddisfa std::function in C++23: usa std::move_only_function. La cattura per riferimento non estende la vita e può restare dangling. target<T>() richiede il tipo memorizzato esatto e la firma del wrapper non conserva noexcept.
Esempi
#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';
}
Risultato
15 0
std::function → 15 0