std::ref, std::cref

来自cppreference.com
< cpp‎ | utility‎ | functional
 
 
工具库
语言支持
类型支持(基本类型、RTTI)
库功能特性测试宏 (C++20)
动态内存管理
程序工具
协程支持 (C++20)
变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)

 
函数对象
函数调用
(C++17)(C++23)
恒等函数对象
(C++20)
引用包装器
refcref
(C++11)(C++11)
通透运算符包装器
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

旧式绑定器与适配器
(C++17 前*)
(C++17 前*)
(C++17 前*)
(C++17 前*)
(C++17 前*)(C++17 前*)(C++17 前*)(C++17 前*)
(C++20 前*)
(C++20 前*)
(C++17 前*)(C++17 前*)
(C++17 前*)(C++17 前*)

(C++17 前*)
(C++17 前*)(C++17 前*)(C++17 前*)(C++17 前*)
(C++20 前*)
(C++20 前*)
 
在标头 <functional> 定义
template< class T >
std::reference_wrapper<T> ref( T& t ) noexcept;
(1) (C++11 起)
(C++20 起为 constexpr)
template< class T >

std::reference_wrapper<T>

    ref( std::reference_wrapper<T> t ) noexcept;
(2) (C++11 起)
(C++20 起为 constexpr)
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 起)
(C++20 起为 constexpr)
template< class T >

std::reference_wrapper<const T>

    cref( std::reference_wrapper<T> t ) noexcept;
(5) (C++11 起)
(C++20 起为 constexpr)
template< class T >
void cref( const T&& ) = delete;
(6) (C++11 起)

函数模板 refcref 是生成 std::reference_wrapper 类型对象的辅助函数,它们用模板实参推导确定结果的模板实参。

T 可为不完整类型。

(C++20 起)

参数

t - 需要被包装的到对象的左值引用,或 std::reference_wrapper 的实例

返回值

2) t
4) std::reference_wrapper<const T>(t)
5) t
3,6) 右值引用包装器被弃置。

示例

#include <functional>
#include <iostream>
 
void f(int& n1, int& n2, const int& n3)
{
    std::cout << "函数中: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
    ++n1; // 增加存储于函数对象的 n1 副本
    ++n2; // 增加 main() 的 n2
    // ++n3; // 编译错误
}
 
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 << "函数前: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
    bound_f();
    std::cout << "函数后: " << n1 << ' ' << n2 << ' ' << n3 << '\n';
}

输出:

函数前: 10 11 12
函数中: 1 11 12
函数后: 10 12 12

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 3146 C++11 解包装重载有时导致错误 使之始终合法

参阅

可复制构造 (CopyConstructible) 可复制赋值 (CopyAssignable) 的引用包装器
(类模板)