_strdup_dbg、_wcsdup_dbg
malloc のデバッグ バージョンを使用する _strdup and _wcsdup のバージョン。
char *_strdup_dbg( const char *strSource, int blockType, const char *filename, int linenumber ); wchar_t *_wcsdup_dbg( const wchar_t *strSource, int blockType, const char *filename, int linenumber );
パラメーター
strSource
NULL で終わる元の文字列。blockType
要求するメモリ ブロックの種類。_CLIENT_BLOCK または _NORMAL_BLOCK。filename
割り当て操作を要求したソース ファイル名へのポインターまたは NULL。linenumber
割り当て操作が要求されたソース ファイル内の行番号または NULL。
戻り値
これらの各関数は、コピーされた文字列の格納場所へのポインター、またはストレージを割り当てることができない場合は NULL を返します。
解説
_strdup_dbg および _wcsdup_dbg 関数は _strdup および _wcsdup と同じものですが、_DEBUG が定義されている場合に、これらの関数は複製された文字列にメモリを割り当てるために malloc および _malloc_dbg のデバッグ バージョンを使用する点が異なります。 _malloc_dbg のデバッグ機能の詳細については、「_malloc_dbg」を参照してください。
多くの場合、これらの関数を明示的に呼び出す必要はありません。 代わりに、フラグ _CRTDBG_MAP_ALLOC を定義することができます。 _CRTDBG_MAP_ALLOC が定義されている場合、_strdup および _wcsdup の呼び出しはそれぞれ _strdup_dbg および _wcsdup_dbg にマップし直され、blockType が _NORMAL_BLOCK に設定されます。 そのため、ヒープ ブロックを _CLIENT_BLOCK としてマークする場合以外は、これらの関数を明示的に呼び出す必要はありません。 ブロックの型の詳細については、「デバッグ ヒープ上のメモリ ブロックの型」を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tcsdup_dbg |
_strdup_dbg |
_mbsdup |
_wcsdup_dbg |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_strdup_dbg, _wcsdup_dbg |
<crtdbg.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのデバッグ バージョン。