_fullpath_dbg、_wfullpath_dbg
メモリを割り当てるために malloc のデバッグ バージョンを使用する _fullpath、_wfullpath のバージョン。
char *_fullpath_dbg(
char *absPath,
const char *relPath,
size_t maxLength,
int blockType,
const char *filename,
int linenumber
);
wchar_t *_wfullpath_dbg(
wchar_t *absPath,
const wchar_t *relPath,
size_t maxLength,
int blockType,
const char *filename,
int linenumber
);
パラメーター
absPath
格納するバッファーへのポインター絶対パスまたは絶対パス名 (NULL。relPath
相対パス名。maxLength
絶対パス名のバッファー ()absPath の最大長。この長さは _fullpath のバイトには _wfullpath のワイド文字 wchar_t() にあります。blockType
メモリ ブロックの要求された型 : _CLIENT_BLOCK または _NORMAL_BLOCK。filename
ソース ファイルの名前へのポインター要求された割り当て操作または NULL。linenumber
割り当ての操作が要求または NULL のソース ファイルの行番号。
戻り値
各格納するバッファーへのポインターを返します。絶対パス名 (absPath)。relPath で渡される値が無効または見つからないまたは作成された絶対パス名 (absPath) の長さが maxLength より大きい場合) ドライブ文字が含まれている関数の戻り値 NULL エラーの場合 (たとえば。
解説
_fullpath_dbg と _wfullpath_dbg の関数は _fullpath と _wfullpath と同じものですが**_**DEBUG が 定義されている場合null 値が最初のパラメーターとして渡されたこれらの関数でメモリを割り当てるために malloc_malloc_dbg のデバッグ バージョンを使用します。_malloc_dbg のデバッグ機能の詳細については_malloc_dbg を参照してください。
ほとんどの場合これらの関数を明示的に呼び出す必要はありません。代わりに_CRTDBG_MAP_ALLOC フラグを定義できます。_CRTDBG_MAP_ALLOC が 定義されている場合_fullpath の呼び出しと _wfullpath は _NORMAL_BLOCK への blockType に設定 _fullpath_dbg と _wfullpath_dbg にそれぞれ再マップされます。したがって _CLIENT_BLOCKヒープのブロックを指定しない場合はこれらの関数を明示的に呼び出す必要はありません。詳細については、「デバッグ ヒープ上のメモリ ブロックの型」を参照してください。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
必要条件
Function |
必須ヘッダー |
|---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。