База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници