_getcwd_dbg, _wgetcwd_dbg

Debug versi _getcwd, _wgetcwd fungsi (hanya tersedia selama debug).

Sintaks

char *_getcwd_dbg(
   char *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wgetcwd_dbg(
   wchar_t *buffer,
   int maxlen,
   int blockType,
   const char *filename,
   int linenumber
);

Parameter

buffer
Lokasi penyimpanan untuk jalur.

maxlen
Panjang maksimum jalur dalam karakter: char untuk _getcwd_dbg dan wchar_t untuk _wgetcwd_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

Mengembalikan penunjuk ke buffer. NULL Nilai pengembalian menunjukkan kesalahan, dan errno diatur baik ke ENOMEM, yang menunjukkan bahwa tidak ada cukup memori untuk mengalokasikan maxlen byte (ketika NULL argumen diberikan sebagai buffer), atau ke ERANGE, menunjukkan bahwa jalur lebih panjang dari maxlen karakter.

Untuk informasi selengkapnya, lihat errno, _doserrno, _sys_errlist, dan _sys_nerr.

Keterangan

Fungsi _getcwd_dbg dan _wgetcwd_dbg identik dengan _getcwd dan _wgetcwd kecuali bahwa, ketika _DEBUG didefinisikan, fungsi-fungsi ini menggunakan versi malloc debug dan _malloc_dbg untuk mengalokasikan memori jika NULL diteruskan sebagai parameter pertama. Untuk informasi selengkapnya, 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 _getcwd dan _wgetcwd dipetakan ulang ke _getcwd_dbg dan _wgetcwd_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
_tgetcwd_dbg	_getcwd_dbg	_getcwd_dbg	_wgetcwd_dbg

Persyaratan

Rutin	Header yang diperlukan
_getcwd_dbg	<crtdbg.h>
_wgetcwd_dbg	<crtdbg.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

_getcwd, _wgetcwd
Kontrol direktori
Versi debug fungsi alokasi timbunan