std::set_new_handler

来自cppreference.com
< cpp‎ | memory‎ | new
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(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++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)



 
 
在标头 <new> 定义
std::new_handler set_new_handler( std::new_handler new_p ) throw();
(C++11 前)
std::new_handler set_new_handler( std::new_handler new_p ) noexcept;
(C++11 起)

new_p 成为新的全局 new 处理函数并返回先前安装的 new 处理函数。

new 处理函数是为分配函数在凡是内存分配尝试失败时调用的函数。其目的是三件事之一:

1) 令更多内存可用
2) 终止程序(例如通过调用 std::terminate
3) 抛出 std::bad_alloc 或自 std::bad_alloc 导出的类型的异常。

默认实现抛 std::bad_alloc 。用户可以安装自己的 new 处理函数,并可以提供异于默认者的行为。

new 处理函数返回,则分配函数重复先前失败的分配,并若分配再次失败则调用 new 处理函数。为终止循环, new 处理函数可调用 std::set_new_handler(nullptr) :若在失败的分配尝试后,分配函数发现 std::get_new_handler 返回空指针值,则它会试图抛出 std::bad_alloc

在程序启动时, new 处理函数是空指针。

此函数是线程安全的。每个对 std::set_new_handler 的调用同步于(见 std::memory_order )后继的 std::set_new_handlerstd::get_new_handler 调用。

(C++11 起)

参数

new_p - std::new_handler 类型的指向函数指针,或空指针

返回值

先前安装的 new 处理函数,或若无安装者则返回空指针。

示例

#include <iostream>
#include <new>
 
void handler()
{
    std::cout << "Memory allocation failed, terminating\n";
    std::set_new_handler(nullptr);
}
 
int main()
{
    std::set_new_handler(handler);
    try {
        while (true) {
            new int[100000000ul];
        }
    } catch (const std::bad_alloc& e) {
        std::cout << e.what() << '\n';
    }
}

输出:

Memory allocation failed, terminating
std::bad_alloc

参阅

分配函数
(函数)
获得当前的 new 处理函数
(函数)
new 处理函数的函数指针类型
(typedef)
内存分配失败时抛出的异常
(类)