CKTIS / C++
std::reference_wrapper — копируем обвиващ обект за препратка
std::reference_wrapper съхранява препратка, без да притежава целевия обект. Научете за std::ref, std::cref и разликата между промяната на реферирания обект и смяната на обекта, към който сочи обвивката.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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> от <functional> е копируем и присвояваем обект, който обвива препратка към обект или функция. Копието продължава да сочи към същата цел; то не я копира. Това е полезно, когато препратка трябва да бъде представена като обикновена стойност, например в контейнер. При обвит обект, който може да се извиква, operator() препраща извикването към целта.
std::ref(x) създава std::reference_wrapper<T> и запазва типовите квалификатори на x; не премахва const. std::cref(x) създава std::reference_wrapper<const T>, чрез който обектът е достъпен през препратка към тип с квалификатор const. Член-данна, декларирана като mutable, все пак може да се променя директно чрез препратката, която връща get(). Претоварванията, които приемат съществуваща обвивка, запазват нейната цел, вместо да създават вложена обвивка.
get() връща T&; налично е и неявно преобразуване към T&. Сам по себе си const std::reference_wrapper<T> не добавя квалификатор const към типа, към който сочи препратката. За достъп чрез препратка към const T използвайте std::reference_wrapper<const T>. Присвояването r = std::ref(b) променя целта на обвивката, докато r.get() = b присвоява стойност на текущата ѝ цел.
Обвивката не управлява времето на живот на целта и не го удължава. Целта трябва да съществува винаги, когато препратката се използва; в противен случай препратката става невалидна. Изтритите претоварвания на std::ref и std::cref не позволяват обикновени временни обекти да се използват като цел. Претоварванията, които приемат std::reference_wrapper, обаче допускат временни обвивки. Ако a е съществуващ обект от тип int, и std::ref(std::ref(a)), и std::cref(std::ref(a)) са валидни изрази и сочат към a. Обвивката няма конструктор по подразбиране или празно състояние.
Този запис е за C++23. Източникът eel.is е развиващ се проект и може да съдържа по-късни допълнения; този запис не предполага, че те са налични.
Примери
#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';
}
Резултат
15 22 15
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.