std::set_new_handler

来自cppreference.com
< cpp‎ | memory‎ | new
 
 
工具库
类型支持(基本类型、 RTTI 、类型特性)
动态内存管理
错误处理
程序工具
变参数函数
日期和时间
函数对象
(C++11)
关系运算符
optionalanyvariant (C++17)
pair 与 tuple
(C++11)
(C++17)
swap 、 forward 与 move
(C++14)
(C++11)
(C++11)
初等字符串转换
(C++17)
(C++17)
类型运算
(C++11)
(C++17)
 
动态内存管理
 
 
定义于头文件 <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) [编辑]
内存分配失败时抛出的异常
(类) [编辑]