CKTIS / C++
std::reference_wrapper — kopirljivi omotač reference
std::reference_wrapper pohranjuje referencu, a nije vlasnik ciljnog objekta. Saznajte više o std::ref, std::cref i razlici između mijenjanja referenciranog objekta i promjene objekta na koji omotač upućuje.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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> iz <functional> kopirljiv je i dodjeljiv objekt koji omata referencu na objekt ili funkciju. Kopija i dalje upućuje na isti cilj; ne kopira ga. Koristan je kada referencu treba prikazati kao običnu vrijednost, primjerice u spremniku. Ako je omotani objekt pozivljiv, operator() prosljeđuje poziv cilju.
std::ref(x) stvara std::reference_wrapper<T> i pritom čuva tipske kvalifikatore od x; ne uklanja const. std::cref(x) stvara std::reference_wrapper<const T>, koji omogućuje pristup objektu putem reference na tip s kvalifikatorom const. Podatkovni član deklariran kao mutable i dalje se može izravno mijenjati putem reference koju vraća get(). Preopterećenja koja prihvaćaju postojeći omotač čuvaju njegov cilj umjesto da stvaraju ugniježđeni omotač.
get() vraća T&; dostupna je i implicitna pretvorba u T&. const std::reference_wrapper<T> sam po sebi ne dodaje kvalifikator const tipu na koji referenca upućuje. Za pristup putem reference na const T upotrijebite std::reference_wrapper<const T>. Dodjela r = std::ref(b) mijenja cilj omotača, dok r.get() = b dodjeljuje vrijednost njegovu trenutačnom cilju.
Omotač ne upravlja životnim vijekom cilja niti ga produljuje. Cilj mora postojati kad god se referenca upotrebljava; u suprotnom referenca postaje viseća. Izbrisana preopterećenja funkcija std::ref i std::cref ne dopuštaju upotrebu običnih privremenih objekata kao ciljeva. Međutim, preopterećenja koja primaju std::reference_wrapper prihvaćaju i privremene omotače. Ako je a postojeći objekt tipa int, izrazi std::ref(std::ref(a)) i std::cref(std::ref(a)) valjani su i oba upućuju na a. Omotač nema zadani konstruktor ni prazno stanje.
Ovaj se unos odnosi na C++23. Izvor eel.is nacrt je koji se neprestano razvija i može sadržavati kasnije dodatke; ovaj unos ne pretpostavlja da su oni dostupni.
Primjeri
#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';
}
Rezultat
15 22 15
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.