std::declare_reachable

< cpp‎ | memory
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
动态内存管理
智能指针
(C++11)
(C++11)
(C++11)
(C++17 前)
(C++11)
分配器
内存资源
未初始化存储
未初始化内存算法
有制约的未初始化内存算法
垃圾收集支持
declare_reachable
(C++11)
杂项
(C++20)
(C++11)
(C++11)
C 库
低层内存管理
 
定义于头文件 <memory>
void declare_reachable( void* p );
(C++11 起)

声明 p 所引用的对象可抵达。可抵达对象将不为垃圾收集器删除,或不被泄漏检测器认为是泄露,即使所有指向它的指针都被销毁。对象可以声明为多次可抵达,该情况下会需要多次调用 std::undeclare_reachable 以移除此属性。例如,若实现拥有启用的垃圾收集,则异或链表需要声明其结点为可抵达。

参数

p - 安全导出的指针或空指针

返回值

(无)

异常

若系统不能分配追踪可抵达对象所要求的内存,则可能抛出 std::bad_alloc

示例

参阅

声明一个对象可以被回收
(函数模板)