std::set_new_handler

std::new_handler set_new_handler( std::new_handler new_p ) throw();

std::new_handler set_new_handler( std::new_handler new_p ) noexcept;

使得 new_p 成为新的全局 new-handler 函数，并返回先前安装的 new-handler。

new-handler 函数是分配函数在内存分配尝试失败时调用的函数。其预期目的是以下三者之一：

默认实现抛出 std::bad_alloc。用户可以安装自己的 new-handler，其行为可能不同于默认实现。

如果 new-handler 返回，分配函数会重复之前失败的分配尝试，并在分配再次失败时再次调用 new-handler。要结束循环，new-handler 可以调用 std::set_new_handler(nullptr)：如果分配失败后，分配函数发现 std::get_new_handler 返回空指针值，它将抛出 std::bad_alloc。

在程序启动时，new-handler 是一个空指针。

参数

返回值

先前安装的新处理函数，若无安装则返回空指针值。

示例

#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[1000'000'000ul]();
        }
    }
    catch (const std::bad_alloc& e)
    {
        std::cout << e.what() << '\n';
    }
}

Memory allocation failed, terminating
std::bad_alloc

参见