std::reference_wrapper 是轻量引用包装器,解决原生引用不可赋值、不可默认构造导致无法存入容器的问题;它内部存储指针,支持隐式转换为引用和重新绑定,常用 std::ref()/std::cref() 创建。

std::reference_wrapper 是什么,为什么不能直接用引用当容器元素
因为 C++ 容器(比如 std::vector、std::list)要求元素类型必须可赋值、可拷贝(或至少可移动),而原生引用(T&)不满足——它不可重新绑定,也不能默认构造。所以你写 std::vector<int></int> 会编译失败,报错类似:error: forming pointer to reference type 'int&' 或更隐晦的模板实例化失败。
std::reference_wrapper 就是为此设计的:它是个轻量包装器,内部存的是指针,但行为像引用——支持隐式转换为所包装类型的引用,也支持重新绑定(通过 get() 和赋值操作符)。
怎么创建和使用 std::reference_wrapper
最常用方式是调用辅助函数 std::ref() 和 std::cref(),它们返回 std::reference_wrapper<t></t> 或 std::reference_wrapper<const t></const>:
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
int a = 10, b = 20;
std::vector<:reference_wrapper>> refs = {std::ref(a), std::ref(b)};
refs[0].get() = 99; // 修改 a → a 变成 99
std::cout
<ul>
<li>不要手动写 <code>std::reference_wrapper<int>(a)</int></code> —— 容易漏掉模板参数,且不如 <code>std::ref</code> 清晰</li>
<li>
<code>std::cref(x)</code> 用于只读场景,比如存 const 引用;它返回的 wrapper 不能被赋值(<code>operator=</code> 被删除)</li>
<li>访问值时:用 <code>.get()</code> 显式取引用,或直接用(隐式转换):<code>int& r = refs[0];</code> 是合法的</li>
</ul>
<h3>在 std::function 和线程中传引用参数时的典型误用</h3>
<p>很多人以为把 <code>std::ref(x)</code> 传给 <code>std::thread</code> 或 <code>std::function</code> 就能安全传递引用——其实只对「被调用函数形参是引用」才真正起作用。否则,wrapper 本身会被拷贝,而它包装的仍是原变量的引用,这没问题;但若你忘了在目标函数里声明为引用,就会意外拷贝值:</p>
<pre class="brush:php;toolbar:false;">void f(int& x) { x *= 2; }
int v = 5;
std::thread t(f, std::ref(v)); // ✅ 正确:f 接收 int&,修改 v
t.join(); // v 变成 10
void g(int x) { x *= 2; } // 形参是值类型!
std::thread t2(g, std::ref(v)); // ❌ 无意义:v 仍被拷贝进 x,原 v 不变
- 传参时用
std::ref≠ 自动转成引用调用,最终是否修改原变量,取决于目标函数签名 -
std::function<void></void>存储带引用参数的可调用对象时,std::ref才是必需的;若存的是std::function<void></void>,传std::ref也没用 - 注意生命周期:wrapper 不管理所引对象的生存期,若原对象提前析构,再访问就是悬垂引用
和普通指针、std::shared_ptr 的关键区别在哪
std::reference_wrapper 不是智能指针,也不拥有资源,它只是“可重绑定的引用代理”。对比起来:
- 比裸指针安全:不会出现空状态(构造时必须绑定有效对象),且语法上更接近引用(支持
++r、r += 1等) - 比
std::shared_ptr轻量:零开销抽象,无引用计数、无堆分配,仅存储一个指针大小(通常 8 字节) - 不能用在需要所有权语义的地方:比如你想让容器“持有”对象,就该用
std::unique_ptr或值语义;reference_wrapper只适合“观察/操作已有对象” - 不支持多态向下转型:不能像
std::shared_ptr<base>那样指向Derived并安全转换;它包装的是确切类型
最容易被忽略的一点:它没有默认构造函数,也没有空状态——一旦构造就必须绑到有效对象,这个约束既是安全保证,也是使用时必须主动满足的前提。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










