mallocの_set_new_modeによって設定されたnew ハンドラー モードを示す整数を返します。
構文
int _query_new_mode(
void
);
戻り値
mallocの現在のnew ハンドラー モード (0 または 1) を返します。 戻り値 1 は、メモリの割り当てに失敗した場合、mallocnew ハンドラー ルーチンを呼び出すことを示します。戻り値 0 は、割り当てないことを示します。
解説
C++ _query_new_mode関数は、mallocの C++ _set_new_mode関数によって設定されるnew ハンドラー モードを示す整数を返します。 new ハンドラー モードは、メモリの割り当てに失敗した場合、malloc_set_new_handlerによって設定されたnew ハンドラー ルーチンを呼び出すかどうかを示します。 既定では、 malloc は障害発生時に new ハンドラー ルーチンを呼び出しません。 _set_new_modeを使用すると、この動作をオーバーライドして、障害発生時にmallocnew演算子がメモリの割り当てに失敗したときに行うのと同じ方法でnew ハンドラー ルーチンを呼び出すことができます。 詳細については、C++ 言語リファレンスの「new および delete 演算子」の説明を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_query_new_mode |
<new.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。