CKTIS / C++
std::reference_wrapper — ein kopierbarer Referenz-Wrapper
std::reference_wrapper speichert eine Referenz, ohne das Zielobjekt zu besitzen. Erfahre mehr über std::ref, std::cref und den Unterschied zwischen dem Ändern des referenzierten Objekts und dem Ändern des Objekts, auf das der Wrapper verweist.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <functional>
std::reference_wrapper<T> wrapper = std::ref(object);
std::reference_wrapper<const T> readonly = std::cref(object);
wrapper.get();std::reference_wrapper<T> aus <functional> ist ein kopierbares und zuweisbares Objekt, das eine Referenz auf ein Objekt oder eine Funktion umschließt. Eine Kopie verweist weiterhin auf dasselbe Ziel; sie kopiert das Ziel nicht. Das ist nützlich, wenn eine Referenz als gewöhnlicher Wert dargestellt werden muss, zum Beispiel in einem Container. Bei einem umschlossenen aufrufbaren Objekt leitet operator() den Aufruf an das Ziel weiter.
std::ref(x) erzeugt std::reference_wrapper<T> und erhält dabei die Typqualifizierer von x; const wird nicht entfernt. std::cref(x) erzeugt std::reference_wrapper<const T> und ermöglicht so den Zugriff auf ein Objekt über eine Referenz auf einen const-qualifizierten Typ. Ein als mutable deklariertes Datenelement lässt sich weiterhin direkt über die von get() zurückgegebene Referenz ändern. Überladungen, die einen bestehenden Wrapper annehmen, behalten dessen Ziel bei, statt einen verschachtelten Wrapper zu erzeugen.
get() gibt T& zurück; außerdem ist eine implizite Konvertierung zu T& verfügbar. Ein const std::reference_wrapper<T> fügt dem referenzierten Typ nicht von sich aus const hinzu. Verwende für den Zugriff über eine Referenz auf const T den Typ std::reference_wrapper<const T>. Die Zuweisung r = std::ref(b) ändert das Ziel des Wrappers, während r.get() = b dem aktuellen Ziel einen Wert zuweist.
Der Wrapper verwaltet die Lebensdauer seines Ziels nicht und verlängert sie auch nicht. Das Ziel muss existieren, solange die Referenz verwendet wird; andernfalls wird sie zu einer hängenden Referenz. Die gelöschten Überladungen von std::ref und std::cref lassen gewöhnliche temporäre Objekte nicht als Ziel zu. Die Überladungen, die einen std::reference_wrapper entgegennehmen, akzeptieren jedoch temporäre Wrapper. Ist a ein vorhandenes Objekt vom Typ int, sind sowohl std::ref(std::ref(a)) als auch std::cref(std::ref(a)) gültig und verweisen auf a. Der Wrapper hat weder einen Standardkonstruktor noch einen leeren Zustand.
Dieser Eintrag bezieht sich auf C++23. Die eel.is-Quelle ist ein fortlaufend weiterentwickelter Entwurf und kann spätere Ergänzungen enthalten; dieser Eintrag setzt deren Verfügbarkeit nicht voraus.
Beispiele
#include <functional>
#include <iostream>
int main() {
int a = 10;
int b = 20;
auto r = std::ref(a);
auto copy = r;
const auto readonly = std::cref(a);
copy.get() += 5;
r = std::ref(b);
r.get() += 2;
std::cout << a << ' ' << b << ' ' << readonly.get() << '\n';
}
Ergebnis
15 22 15
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.