std::set_new_handler

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

初等字符串转换
(C++17)
(C++17)
(C++17)
 
动态内存管理
智能指针
(C++11)
(C++11)
(C++11)
(C++17 前)
(C++11)
(C++11)
(C++11)
(C++11)
分配器
(C++11)
(C++11)
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++17)
内存资源
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
未初始化存储
(C++20 前)
(C++20 前)
(C++20 前)
未初始化内存算法
有制约的未初始化内存算法
垃圾收集支持
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
杂项
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
C 库
低层内存管理
 
低层内存管理
 
定义于头文件 <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_handler 和 std::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

参阅

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