Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori