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-handler関数を設定し、new_p 以前に設定されていたnew-handlerを返します。

new-handler 関数は、メモリ割り当て試行が失敗したときに割り当て関数によって呼び出される関数です。その意図された目的は次の3つのいずれかです：

デフォルトの実装はstd::bad_allocを投げます。ユーザーは独自のnew-handlerをインストールでき、デフォルトとは異なる動作を提供できます。

new-handlerが戻った場合、割り当て関数は以前に失敗した割り当て試行を繰り返し、再び割り当てが失敗した場合は再びnew-handlerを呼び出します。ループを終了するために、new-handlerはstd::set_new_handler(nullptr)を呼び出すことができます：割り当て試行が失敗した後、割り当て関数がstd::get_new_handlerがnullポインタ値を返すことを検出した場合、std::bad_allocを投げます。

プログラム起動時、new-handlerはnullポインタです。

パラメータ

戻り値

以前にインストールされていた new ハンドラ、またはインストールされていない場合は null ポインタ値。

例

#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

関連項目