std::set_new_handler

定义于头文件 <new>
std::new_handler set_new_handler( std::new_handler new_p );

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 处理函数,或若无安装者则返回空指针。

异常

(无) (C++11 前)
noexcept 规定:  
noexcept
  
(C++11 起)

示例

#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)
内存分配失败时抛出的异常
(类)

版本历史

  • (当前 | 先前 2017年5月17日 (三) 03:58Fruderica讨论 | 贡献. . (2,488字节) (-999). . (撤销)
  • 当前 | 先前 2014年10月26日 (日) 17:56P12bot讨论 | 贡献 . . (3,487字节) (0). . (Fix some translations) (撤销)
  • 当前 | 先前 2013年7月2日 (二) 09:04P12bot讨论 | 贡献 . . (3,487字节) (-113). . (Use {{lc}}. Update links. Various fixes.) (撤销)
  • 当前 | 先前 2012年11月2日 (五) 15:50P12bot讨论 | 贡献 . . (3,600字节) (+305). . (r2.7.3) (机器人添加:de, en, es, fr, it, ja, pt, ru) (撤销)
  • 当前 | 先前 2012年10月27日 (六) 03:26P12讨论 | 贡献 . . (3,295字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 06:00TranslationBot讨论 | 贡献. . (3,295字节) (-93). . (Translated from the English version using Google Translate) (撤销)
  • 当前 | 先前 2012年10月25日 (四) 14:09P12讨论 | 贡献 . . (3,388字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前) 2012年10月25日 (四) 12:00TranslationBot讨论 | 贡献. . (3,388字节) (+3,388). . (Translated from the English version using Google Translate)