std::set_new_handler
提供: cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev ">
</tbody><tbody>
</tbody>
| ヘッダ <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 ハンドラ関数は、メモリ確保の試みが失敗したときに、確保関数によって呼ばれる関数です。 その意図されている目的は、以下の3つのいずれかです。
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 ハンドラはヌルポインタです。
|
この関数はスレッドセーフです。 |
(C++11以上) |
引数
| new_p | - | std::new_handler 型の関数ポインタ、またはヌルポインタ |
戻り値
それまで設定されていた new ハンドラ、または設定されていなかった場合はヌルポインタ。
例
Run this code
#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) | |
| メモリ確保が失敗したときに投げられる例外 (クラス) |