Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła