CKTIS / C++
std::reference_wrapper — een kopieerbare referentiewrapper
std::reference_wrapper slaat een verwijzing op zonder eigenaar van het doelobject te zijn. Lees over std::ref, std::cref en het verschil tussen het wijzigen van het object waarnaar de wrapper verwijst en de wrapper naar een ander object laten verwijzen.
Versie: 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> uit <functional> is een kopieerbaar en toewijsbaar object dat een verwijzing naar een object of functie omhult. Een kopie verwijst nog steeds naar hetzelfde doel; het doel wordt niet gekopieerd. Dit is handig wanneer een verwijzing als een gewone waarde moet worden weergegeven, bijvoorbeeld in een container. Als het omhulde object aanroepbaar is, geeft operator() de aanroep door aan het doel.
std::ref(x) maakt een std::reference_wrapper<T> en behoudt daarbij de typekwalificaties van x; const wordt niet verwijderd. std::cref(x) maakt een std::reference_wrapper<const T>, die toegang geeft tot een object via een verwijzing naar een type met de kwalificatie const. Een gegevenslid dat als mutable is gedeclareerd, kun je nog steeds rechtstreeks wijzigen via de verwijzing die get() retourneert. Overloads die een bestaande wrapper accepteren, behouden het doel daarvan in plaats van een geneste wrapper te maken.
get() retourneert T&; ook een impliciete conversie naar T& is beschikbaar. Een const std::reference_wrapper<T> voegt op zichzelf geen const toe aan het type waarnaar de wrapper verwijst. Gebruik std::reference_wrapper<const T> voor toegang via een verwijzing naar const T. Met r = std::ref(b) verander je het doel van de wrapper; met r.get() = b wijs je een waarde toe aan het huidige doel.
De wrapper beheert de levensduur van het doel niet en verlengt die ook niet. Het doel moet bestaan zolang de verwijzing wordt gebruikt; anders gaat de verwijzing naar een niet meer geldig object wijzen. De verwijderde overloads van std::ref en std::cref staan gewone tijdelijke objecten niet als doel toe. De overloads die een std::reference_wrapper aannemen, accepteren echter wel tijdelijke wrappers. Als a een bestaand object van het type int is, zijn zowel std::ref(std::ref(a)) als std::cref(std::ref(a)) geldig en verwijzen beide naar a. De wrapper heeft geen standaardconstructor en geen lege toestand.
Dit artikel is gericht op C++23. De eel.is-bron is een voortdurend veranderend concept en kan latere toevoegingen bevatten; dit artikel gaat er niet van uit dat die beschikbaar zijn.
Voorbeelden
#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';
}
Resultaat
15 22 15
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.