_fullpath_dbg
, _wfullpath_dbg
_fullpath
Versi , _wfullpath
yang menggunakan versi malloc
debug untuk mengalokasikan memori.
Sintaks
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
);
Parameter
absPath
Penunjuk ke buffer yang berisi nama jalur absolut atau lengkap, atau NULL
.
relPath
Nama jalur relatif.
maxLength
Panjang maksimum buffer nama jalur absolut (absPath
). Panjang ini dalam byte untuk _fullpath_dbg
tetapi dalam karakter lebar (wchar_t
) untuk _wfullpath_dbg
.
blockType
Jenis blok memori yang diminta: _CLIENT_BLOCK
atau _NORMAL_BLOCK
.
filename
Penunjuk ke nama file sumber yang meminta operasi alokasi atau NULL
.
linenumber
Nomor baris dalam file sumber tempat operasi alokasi diminta atau NULL
.
Nilai hasil
Setiap fungsi mengembalikan penunjuk ke buffer yang berisi nama jalur absolut (absPath
). Jika ada kesalahan (misalnya, jika nilai yang diteruskan relPath
menyertakan huruf drive yang tidak valid atau tidak dapat ditemukan, atau jika panjang nama jalur absolut yang dibuat (absPath
) lebih besar dari maxLength
) fungsi mengembalikan NULL
.
Keterangan
Fungsi _fullpath_dbg
dan _wfullpath_dbg
identik dengan _fullpath
dan _wfullpath
kecuali bahwa, ketika _DEBUG
didefinisikan, fungsi-fungsi ini menggunakan versi debug dari malloc
, _malloc_dbg
, untuk mengalokasikan memori jika NULL
diteruskan sebagai parameter pertama. Untuk informasi tentang fitur _malloc_dbg
penelusuran kesalahan , lihat _malloc_dbg
.
Anda tidak perlu memanggil fungsi-fungsi ini secara eksplisit dalam banyak kasus. Sebagai gantinya _CRTDBG_MAP_ALLOC
, Anda dapat menentukan bendera. Ketika _CRTDBG_MAP_ALLOC
didefinisikan, panggilan ke _fullpath
dan _wfullpath
dipetakan ulang ke _fullpath_dbg
dan _wfullpath_dbg
, masing-masing, dengan blockType
diatur ke _NORMAL_BLOCK
. Dengan demikian, Anda tidak perlu memanggil fungsi-fungsi ini secara eksplisit kecuali Anda ingin menandai blok tumpukan sebagai _CLIENT_BLOCK
. Untuk informasi selengkapnya, lihat Jenis blok pada tumpukan debug.
Pemetaan rutin teks generik
Rutinitas Tchar.h | _UNICODE dan _MBCS tidak ditentukan |
_MBCS Didefinisikan |
_UNICODE Didefinisikan |
---|---|---|---|
_tfullpath_dbg |
_fullpath_dbg |
_fullpath_dbg |
_wfullpath_dbg |
Persyaratan
Fungsi | Header yang diperlukan |
---|---|
_fullpath_dbg |
<crtdbg.h> |
_wfullpath_dbg |
<crtdbg.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Lihat juga
Penanganan file
_fullpath
, _wfullpath
Versi debug fungsi alokasi timbunan