CKTIS / C++
std::function: kopierbarer Aufrufwrapper
std::function speichert jedes kopierbare, zur Signatur passende aufrufbare Objekt und ruft es über eine einheitliche Schnittstelle auf.
Version: 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...)> aus <functional> ist ein polymorpher Wrapper mit Typlöschung. Er kann Funktionszeiger, Funktor, Bindung oder Lambda halten, wenn der gespeicherte Typ kopierbar und mit Args... zu einem mit R kompatiblen Ergebnis aufrufbar ist. Der Wrapper ist kopier- und verschiebbar; beim Kopieren wird das Ziel kopiert, sodass Wert-Captures zu jeder Zielkopie gehören.
Das Beispiel speichert eine Lambda-Funktion mit dem Wert-Capture factor in std::function<int(int)>. std::function::operator() ruft das gespeicherte Ziel auf, daher liefert scale(5) den Wert 15. std::function::operator bool meldet, ob der Wrapper ein Ziel enthält; der zweite Wrapper ist standardkonstruiert, daher ist static_cast<bool>(empty) falsch und die Ausgabe lautet 15 0. Vor dem Aufruf eines optionalen Callbacks sollte der boolesche Zustand geprüft werden, sofern der leere Fall nicht absichtlich per Ausnahme behandelt wird.
Der Aufruf eines leeren Wrappers wirft std::bad_function_call; Ausnahmen des Ziels werden weitergereicht. Die Konstruktion kann allozieren und std::bad_alloc oder jede Ausnahme der Zielinitialisierung werfen, einschließlich eines auslösenden Verschiebens aus einem Rvalue-Argument; Small-Object-Optimierung ist nicht garantiert. Ein nur verschiebbares Lambda erfüllt in C++23 den Vertrag von std::function nicht; dafür gibt es std::move_only_function. Referenz-Captures verlängern keine Lebensdauer und können hängen. target<T>() passt nur zum exakten gespeicherten Typ, und die Signatur bewahrt kein noexcept.
Beispiele
#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';
}
Ergebnis
15 0
std::function → 15 0