std::ref, std::cref
С сайта ru.cppreference.net
| Определён в заголовке <functional>
|
||
template< class T >
std::reference_wrapper<T> ref( T& t ) noexcept;
|
(1) | (начиная с C++11) (constexpr начиная с C++20) |
template< class T >
std::reference_wrapper<T>
ref( std::reference_wrapper<T> t ) noexcept;
|
(2) | (начиная с C++11) (constexpr начиная с C++20) |
template< class T >
void ref( const T&& ) = delete;
|
(3) | (начиная с C++11) |
template< class T >
std::reference_wrapper<const T> cref( const T& t ) noexcept;
|
(4) | (начиная с C++11) (constexpr начиная с C++20) |
template< class T >
std::reference_wrapper<const T>
cref( std::reference_wrapper<T> t ) noexcept;
|
(5) | (начиная с C++11) (constexpr начиная с C++20) |
template< class T >
void cref( const T&& ) = delete;
|
(6) | (начиная с C++11) |
Шаблоны функций ref и cref являются вспомогательными функциями, которые создают объект типа std::reference_wrapper, используя вывод аргументов шаблона для определения аргумента шаблона результата.
|
|
(начиная с C++20) |
Параметры
| t | - | lvalue-ссылка на объект, который нужно обернуть, или экземпляр std::reference_wrapper |
Возвращаемое значение
1)
std::
reference_wrapper
<
T
>
(
t
)
2)
t
4)
std::
reference_wrapper
<
const
T
>
(
t
)
5)
t
3,6)
Обёртка ссылки на rvalue удалена.
Пример
Запустить этот код
#include <functional> #include <iostream> void f(int& n1, int& n2, const int& n3) { std::cout << "In function: " << n1 << ' ' << n2 << ' ' << n3 << '\n'; ++n1; // increments the copy of n1 stored in the function object ++n2; // increments the main()'s n2 // ++n3; // compile error } int main() { int n1 = 1, n2 = 2, n3 = 3; std::function<void()> bound_f = std::bind(f, n1, std::ref(n2), std::cref(n3)); n1 = 10; n2 = 11; n3 = 12; std::cout << "Before function: " << n1 << ' ' << n2 << ' ' << n3 << '\n'; bound_f(); std::cout << "After function: " << n1 << ' ' << n2 << ' ' << n3 << '\n'; }
Вывод:
Before function: 10 11 12 In function: 1 11 12 After function: 10 12 12
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3146 | C++11 | перегрузки разворачивания иногда приводили к ошибке | сделаны всегда валидными |
Смотрите также
|
(C++11)
|
CopyConstructible
и
CopyAssignable
обёртка ссылки
(шаблон класса) |