std::set_new_handler

来自cppreference.com
< cpp‎ | memory‎ | new
 
 
工具库
语言支持
类型支持(基本类型、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++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 << "内存分配失败,终止程序\n";
    std::set_new_handler(nullptr);
}
 
int main()
{
    std::set_new_handler(handler);
    try
    {
        while (true)
        {
            new int[1000'000'000ul]();
        }
    }
    catch (const std::bad_alloc& e)
    {
        std::cout << e.what() << '\n';
    }
}

可能的输出:

内存分配失败,终止程序
std::bad_alloc

参阅

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