CKTIS / C++
std::reference_wrapper — kopírovateľný obal referencie
std::reference_wrapper uchováva referenciu bez toho, aby vlastnil cieľový objekt. Spoznajte std::ref, std::cref a rozdiel medzi úpravou odkazovaného objektu a zmenou objektu, na ktorý obal odkazuje.
Verzia: 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> z <functional> je kopírovateľný a priraditeľný objekt, ktorý obaľuje referenciu na objekt alebo funkciu. Kópia stále odkazuje na ten istý cieľ; nekopíruje ho. Je užitočný, keď treba reprezentovať referenciu ako bežnú hodnotu, napríklad v kontajneri. Pri obalenom volateľnom objekte odovzdá operator() volanie cieľu.
std::ref(x) vytvorí std::reference_wrapper<T> a zachová typové kvalifikátory x; neodstráni const. std::cref(x) vytvorí std::reference_wrapper<const T>, ktorý umožňuje prístup k objektu cez referenciu na typ s kvalifikátorom const. Dátový člen deklarovaný ako mutable možno aj naďalej upraviť priamo cez referenciu, ktorú vráti get(). Preťaženia prijímajúce existujúci obal zachovajú jeho cieľ namiesto vytvorenia vnoreného obalu.
get() vracia T&; dostupná je aj implicitná konverzia na T&. const std::reference_wrapper<T> sám osebe nepridáva k odkazovanému typu kvalifikátor const. Na prístup cez referenciu na const T použite std::reference_wrapper<const T>. Priradenie r = std::ref(b) zmení cieľ obalu, zatiaľ čo r.get() = b priradí hodnotu jeho aktuálnemu cieľu.
Obal nespravuje životnosť cieľa ani ju nepredlžuje. Cieľ musí existovať vždy, keď sa referencia používa; inak referencia začne odkazovať na neplatný objekt. Odstránené preťaženia std::ref a std::cref neumožňujú použiť bežný dočasný objekt ako cieľ. Preťaženia prijímajúce std::reference_wrapper však pripúšťajú aj dočasné obaly. Ak je a existujúci objekt typu int, výrazy std::ref(std::ref(a)) aj std::cref(std::ref(a)) sú platné a odkazujú na a. Obal nemá predvolený konštruktor ani prázdny stav.
Tento záznam sa týka C++23. Zdroj eel.is je priebežne sa vyvíjajúci návrh a môže obsahovať neskoršie doplnenia; tento záznam nepredpokladá ich dostupnosť.
Príklady
#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';
}
Výsledok
15 22 15
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.