`_malloc_dbg`

Artikel
10/12/2023

Mengalokasikan blok memori dalam tumpukan dengan ruang tambahan untuk header debugging dan menimpa buffer (hanya versi debug).

Sintaks

void *_malloc_dbg(
   size_t size,
   int blockType,
   const char *filename,
   int linenumber
);

Parameter

size
Ukuran blok memori yang diminta (dalam byte).

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.

Parameter filename dan linenumber hanya tersedia ketika _malloc_dbg telah dipanggil secara eksplisit atau _CRTDBG_MAP_ALLOC konstanta pra-prosesor telah ditentukan.

Nilai hasil

Setelah berhasil diselesaikan, fungsi ini mengembalikan penunjuk ke bagian pengguna dari blok memori yang dialokasikan, memanggil fungsi handler baru, atau mengembalikan NULL. Untuk deskripsi lengkap tentang perilaku pengembalian, lihat bagian Keterangan berikut ini. Untuk informasi selengkapnya tentang bagaimana fungsi handler baru digunakan, lihat malloc fungsi .

Keterangan

_malloc_dbg adalah versi debug dari malloc fungsi. Ketika _DEBUG tidak ditentukan, setiap panggilan ke _malloc_dbg dikurangi menjadi panggilan ke malloc. Baik malloc dan _malloc_dbg alokasikan blok memori dalam tumpukan dasar, tetapi _malloc_dbg menawarkan beberapa fitur penelusuran kesalahan: buffer di kedua sisi bagian pengguna blok untuk menguji kebocoran, parameter jenis blok untuk melacak jenis alokasi tertentu, dan filename/linenumber informasi untuk menentukan asal permintaan alokasi.

_malloc_dbg mengalokasikan blok memori dengan sedikit lebih banyak ruang daripada yang diminta size. Ruang ekstra digunakan oleh manajer timbunan debug untuk menautkan blok memori debug dan untuk menyediakan aplikasi dengan informasi header debug dan menimpa buffer. Ketika blok dialokasikan, bagian pengguna dari blok diisi dengan nilai 0xCD, dan masing-masing buffer penimpaan diisi dengan 0xFD.

_malloc_dbgerrno diatur ke ENOMEM jika alokasi memori gagal atau jika jumlah memori yang diperlukan (termasuk overhead yang disebutkan sebelumnya) melebihi _HEAP_MAXREQ. Untuk informasi tentang ini dan kode kesalahan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Untuk informasi tentang bagaimana blok memori dialokasikan, diinisialisasi, dan dikelola dalam versi debug timbunan dasar, lihat detail timbunan debug CRT. Untuk informasi tentang jenis blok alokasi dan cara penggunaannya, lihat Jenis blok pada tumpukan debug. Untuk informasi tentang perbedaan antara fungsi timbunan standar dan versi debug, lihat Versi debug fungsi alokasi timbunan.

Persyaratan

Rutin	Header yang diperlukan
`_malloc_dbg`	<crtdbg.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Debug versi pustaka run-time C saja.

Contoh

Untuk sampel cara menggunakan _malloc_dbg, lihat crt_dbg1.