_tempnam_dbg, _wtempnam_dbg

Versi fungsi dari _tempnam, _wtempnam, tmpnam, _wtmpnam yang menggunakan versi debug dari malloc, _malloc_dbg.

Sintaks

char *_tempnam_dbg(
   const char *dir,
   const char *prefix,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wtempnam_dbg(
   const wchar_t *dir,
   const wchar_t *prefix,
   int blockType,
   const char *filename,
   int linenumber
);

Parameter

dir
Jalur yang digunakan dalam nama file jika tidak ada variabel lingkungan TMP, atau jika TMP bukan direktori yang valid.

prefix
String yang akan ditunda sebelumnya ke nama yang dikembalikan oleh _tempnam.

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 nama yang dihasilkan atau NULL jika ada kegagalan. Kegagalan dapat terjadi jika ada nama direktori yang tidak valid yang ditentukan dalam variabel lingkungan TMP dan dalam dir parameter .

Catatan

free (atau free_dbg) perlu dipanggil untuk pointer yang dialokasikan oleh _tempnam_dbg dan _wtempnam_dbg.

Keterangan

Fungsi _tempnam_dbg dan _wtempnam_dbg identik dengan _tempnam dan _wtempnam 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, Anda dapat menentukan bendera _CRTDBG_MAP_ALLOC. Ketika _CRTDBG_MAP_ALLOC didefinisikan, panggilan ke _tempnam dan _wtempnam dipetakan ulang ke _tempnam_dbg dan _wtempnam_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

TCHAR. Rutinitas H _UNICODE dan _MBCS tidak ditentukan _MBCS Didefinisikan _UNICODE Didefinisikan
_ttempnam_dbg _tempnam_dbg _tempnam_dbg _wtempnam_dbg

Persyaratan

Rutin Header yang diperlukan
_tempnam_dbg, _wtempnam_dbg <crtdbg.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

_tempnam, _wtempnam, tmpnam, _wtmpnam
Streaming I/O
Versi debug fungsi alokasi timbunan