CKTIS / C++
std::reference_wrapper — kopírovatelný obal reference
std::reference_wrapper uchovává referenci, aniž by vlastnil cílový objekt. Seznamte se s std::ref, std::cref a rozdílem mezi úpravou odkazovaného objektu a změnou objektu, na který obal odkazuje.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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írovatelný a přiřaditelný objekt, který obaluje referenci na objekt nebo funkci. Kopie stále odkazuje na stejný cíl; cíl nekopíruje. Hodí se, když je třeba reprezentovat referenci jako běžnou hodnotu, například v kontejneru. U obaleného volatelného objektu předává operator() volání cíli.
std::ref(x) vytvoří std::reference_wrapper<T> a zachová typové kvalifikátory x; neodstraní const. std::cref(x) vytvoří std::reference_wrapper<const T>, který umožňuje přístup k objektu přes referenci na typ s kvalifikátorem const. Datový člen deklarovaný jako mutable lze i nadále měnit přímo přes referenci vrácenou metodou get(). Přetížení přijímající existující obal zachovají jeho cíl, místo aby vytvořila vnořený obal.
get() vrací T&; k dispozici je také implicitní konverze na T&. const std::reference_wrapper<T> sám o sobě nepřidává kvalifikátor const k odkazovanému typu. Pro přístup přes referenci na const T použijte std::reference_wrapper<const T>. Přiřazení r = std::ref(b) změní cíl obalu, zatímco r.get() = b přiřadí hodnotu jeho současnému cíli.
Obal nespravuje životnost cíle ani ji neprodlužuje. Cíl musí existovat po celou dobu používání reference; jinak reference začne odkazovat na neplatný objekt. Odstraněná přetížení std::ref a std::cref neumožňují použít běžný dočasný objekt jako cíl. Přetížení přijímající std::reference_wrapper však připouštějí i dočasné obaly. Je-li a existující objekt typu int, výrazy std::ref(std::ref(a)) a std::cref(std::ref(a)) jsou oba platné a odkazují na a. Obal nemá výchozí konstruktor ani prázdný stav.
Tento záznam se vztahuje k C++23. Zdroj eel.is je průběžně se vyvíjející návrh a může obsahovat pozdější doplňky; tento záznam nepředpokládá jejich dostupnost.
Pří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ýsledek
15 22 15
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.