_query_new_mode

[アーティクル]
08/09/2011

_set_new_mode で malloc に対して設定した new ハンドラーモードを示す整数を返します。

int _query_new_mode(
   void 
);

戻り値

malloc に対する現在の new ハンドラーのモード (0 または 1) を返します。戻り値が 1 の場合、メモリの割り当てに失敗すると、malloc が new ハンドラールーチンを呼び出します。戻り値が 0 の場合、malloc は new ハンドラールーチンを呼び出しません。

解説

C++ の _query_new_mode 関数は、C++ の _set_new_mode 関数で malloc に対して設定した new ハンドラーのモードを示す整数を返します。 new ハンドラーのモードに応じて、メモリの割り当てに失敗した場合に、malloc 関数が _set_new_handler で設定されている new ハンドラールーチンを呼び出すかどうかが決まります。既定では、malloc 関数は、メモリの割り当てに失敗しても new ハンドラールーチンを呼び出しません。 _set_new_mode 関数を使用すると、この既定の動作をオーバーライドし、malloc 関数がメモリの割り当てに失敗したときに、new 演算子がメモリの割り当てに失敗したときと同じように new ハンドラールーチンを呼び出すことができます。詳細については、『C++ Language Reference』の operator delete および operator new の説明を参照してください。