std::set_new_handler
来自cppreference.com
| 定义于头文件 <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
默认实现抛 std::bad_alloc 。用户可以安装自己的 new 处理函数，并可以提供异于默认者的行为。
若 new 处理函数返回，则分配函数重复先前失败的分配，并若分配再次失败则调用 new 处理函数。为终止循环， new 处理函数可调用 std::set_new_handler(nullptr) ：若在失败的分配尝试后，分配函数发现 std::get_new_handler 返回空指针值，则它会试图抛出 std::bad_alloc 。
在程序启动时， new 处理函数是空指针。
|
此函数是线程安全的。每个对 |
(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) | |
| 内存分配失败时抛出的异常 (类) |
