CKTIS / C++
std::reference_wrapper — kopiowalne opakowanie referencji
std::reference_wrapper przechowuje referencję bez przejmowania własności obiektu. Poznaj std::ref, std::cref oraz różnicę między zmianą obiektu a zmianą referencji przechowywanej w opakowaniu.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 nagłówka <functional> jest kopiowalnym i przypisywalnym obiektem opakowującym referencję do obiektu lub funkcji. Kopia nadal odnosi się do tego samego celu; nie kopiuje go. Przydaje się, gdy referencję trzeba reprezentować jako zwykłą wartość, na przykład w kontenerze. Dla opakowanego obiektu wywoływalnego operator() przekazuje wywołanie do celu.
std::ref(x) tworzy std::reference_wrapper<T>, zachowując kwalifikatory typu x; nie usuwa const. std::cref(x) tworzy std::reference_wrapper<const T>, który zapewnia dostęp do obiektu przez referencję do typu z kwalifikatorem const. Niestatyczne pole zadeklarowane jako mutable nadal można modyfikować bezpośrednio przez referencję zwracaną przez get(). Przeciążenia przyjmujące istniejące opakowanie zachowują jego cel zamiast tworzyć zagnieżdżone opakowanie.
get() zwraca T&; dostępna jest też niejawna konwersja do T&. Samo const std::reference_wrapper<T> nie dodaje kwalifikatora const do typu wskazywanego przez referencję. Aby uzyskać dostęp przez referencję do const T, użyj std::reference_wrapper<const T>. Przypisanie r = std::ref(b) zmienia cel opakowania, natomiast r.get() = b przypisuje wartość do bieżącego celu.
Opakowanie nie zarządza czasem życia celu ani go nie przedłuża. Cel musi istnieć podczas korzystania z referencji; inaczej staje się ona wisząca. Usunięte przeciążenia std::ref i std::cref uniemożliwiają przekazanie zwykłego obiektu tymczasowego jako celu. Przeciążenia przyjmujące std::reference_wrapper dopuszczają jednak tymczasowe opakowania. Jeśli a jest istniejącym obiektem typu int, zarówno std::ref(std::ref(a)), jak i std::cref(std::ref(a)) są poprawne i odnoszą się do a. Opakowanie nie ma konstruktora domyślnego ani stanu pustego.
Zakres wpisu to C++23. Źródło eel.is jest rozwijanym szkicem i może zawierać późniejsze dodatki; wpis nie zakłada ich dostępności.
Przykłady
#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';
}
Wynik
15 22 15
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.