Rutinitas debug

  • Artikel

Versi debug pustaka runtime C menyediakan banyak layanan diagnostik yang membuat program debugging lebih mudah dan memungkinkan pengembang untuk:

  • Melangkah langsung ke fungsi run-time selama penelusuran kesalahan

  • Mengatasi pernyataan, kesalahan, dan pengecualian

  • Melacak alokasi tumpukan dan mencegah kebocoran memori

  • Melaporkan pesan debug kepada pengguna

Men-debug versi rutinitas pustaka runtime C

Untuk menggunakan rutinitas ini, _DEBUG bendera harus ditentukan. Semua rutinitas ini tidak melakukan apa pun dalam build ritel aplikasi. Untuk informasi selengkapnya tentang cara menggunakan rutinitas debug baru, lihat teknik penelusuran kesalahan CRT.

Rutin Gunakan
_ASSERT Mengevaluasi ekspresi dan menghasilkan laporan debug saat hasilnya FALSE
_ASSERTE Mirip _ASSERTdengan , tetapi menyertakan ekspresi yang gagal dalam laporan yang dihasilkan
_CrtCheckMemory Mengonfirmasi integritas blok memori yang dialokasikan pada tumpukan debug
_CrtDbgBreak Mengatur titik henti.
_CrtDbgReport, _CrtDbgReportW Membuat laporan debug dengan pesan pengguna dan mengirim laporan ke tiga tujuan yang mungkin
_CrtDoForAllClientObjects Memanggil fungsi yang disediakan aplikasi untuk semua _CLIENT_BLOCK jenis pada tumpukan
_CrtDumpMemoryLeaks Buang semua blok memori pada tumpukan debug ketika kebocoran memori yang signifikan telah terjadi
_CrtIsMemoryBlock Verifikasi bahwa blok memori tertentu terletak di dalam timbunan lokal dan memiliki pengidentifikasi jenis blok tumpukan debug yang valid
_CrtIsValidHeapPointer Memverifikasi bahwa penunjuk yang ditentukan berada di tumpukan lokal
_CrtIsValidPointer Verifikasi bahwa rentang memori yang ditentukan valid untuk membaca dan menulis
_CrtMemCheckpoint Dapatkan status tumpukan debug saat ini dan simpan dalam struktur yang disediakan _CrtMemState aplikasi
_CrtMemDifference Membandingkan dua status memori untuk perbedaan yang signifikan dan mengembalikan hasilnya
_CrtMemDumpAllObjectsSince Membuang informasi tentang objek pada timbunan sejak titik pemeriksaan tertentu diambil atau dari awal eksekusi program
_CrtMemDumpStatistics Mencadangkan informasi header debug untuk status memori tertentu dalam formulir yang dapat dibaca pengguna
_CrtReportBlockType Mengembalikan jenis/subjenis blok yang terkait dengan penunjuk blok timbunan debug tertentu.
_CrtSetAllocHook Instal fungsi alokasi yang ditentukan klien dengan menghubungkannya ke dalam proses alokasi memori debug run-time C
_CrtSetBreakAlloc Mengatur titik henti pada nomor urutan alokasi objek tertentu
_CrtSetDbgFlag Mengambil atau mengubah status _crtDbgFlag bendera untuk mengontrol perilaku alokasi manajer timbunan debug
_CrtSetDumpClient Menginstal fungsi yang ditentukan aplikasi yang dipanggil setiap kali fungsi dump debug dipanggil untuk mencadangkan _CLIENT_BLOCK blok memori jenis
_CrtSetReportFile Mengidentifikasi file atau aliran yang akan digunakan sebagai tujuan untuk jenis laporan tertentu menurut _CrtDbgReport
_CrtSetReportHook Instal fungsi pelaporan yang ditentukan klien dengan menghubungkannya ke dalam proses pelaporan debug run-time C
_CrtSetReportHook2, _CrtSetReportHookW2 Menginstal atau menghapus instalan fungsi pelaporan yang ditentukan klien dengan menghubungkannya ke dalam proses pelaporan debug run-time C.
_CrtSetReportMode Tentukan tujuan umum untuk jenis laporan tertentu yang dihasilkan oleh _CrtDbgReport
_RPT[0,1,2,3,4] Lacak kemajuan aplikasi dengan membuat laporan debug dengan memanggil _CrtDbgReport dengan string format dan jumlah variabel argumen. Tidak menyediakan informasi file sumber dan nomor baris.
_RPTF[0,1,2,3,4] Mirip _RPTn dengan makro, tetapi menyediakan nama file sumber dan nomor baris tempat permintaan laporan berasal
_calloc_dbg Mengalokasikan jumlah blok memori tertentu pada tumpukan dengan ruang ekstra untuk header penelusuran kesalahan dan menimpa buffer
_expand_dbg Mengubah ukuran blok memori yang ditentukan pada tumpukan dengan memperluas atau mengontrak blok
_free_dbg Bebaskan satu blok memori pada tumpukan
_fullpath_dbg, _wfullpath_dbg Buat nama jalur absolut atau lengkap untuk nama jalur relatif yang ditentukan, menggunakan _malloc_dbg untuk mengalokasikan memori.
_getcwd_dbg, _wgetcwd_dbg Dapatkan direktori kerja saat ini, menggunakan _malloc_dbg untuk mengalokasikan memori.
_malloc_dbg Alokasikan blok memori pada tumpukan dengan ruang ekstra untuk header debugging dan timpa buffer
_msize_dbg Menghitung ukuran blok memori pada timbunan
_realloc_dbg Merealokasi blok memori yang ditentukan pada tumpukan dengan memindahkan dan/atau mengubah ukuran blok
_strdup_dbg, _wcsdup_dbg Menduplikasi string, menggunakan _malloc_dbg untuk mengalokasikan memori.
_tempnam_dbg, _wtempnam_dbg Buat nama yang dapat Anda gunakan untuk membuat file sementara, menggunakan _malloc_dbg untuk mengalokasikan memori.

Rutinitas runtime C yang tidak tersedia dalam formulir kode sumber

Debugger dapat digunakan untuk menelusuri kode sumber untuk sebagian besar rutinitas runtime C selama proses debugging. Namun, Microsoft menganggap beberapa teknologi sebagai kepemilikan dan, oleh karena itu, tidak menyediakan kode sumber untuk subset rutinitas ini. Sebagian besar rutinitas ini termasuk dalam penanganan pengecualian atau grup pemrosesan floating-point, tetapi beberapa lainnya juga disertakan. Tabel berikut mencantumkan rutinitas ini.

acos
acosh
asin
asinh
atan, atan2
atanh
Bessel functions
_cabs
ceil
_chgsign
_clear87, _clearfp
_control87, _controlfp

copysign
cos
cosh
Exp
fabs
_finite
floor
fmod
_fpclass
_fpieee_flt
_fpreset
frexp

_hypot
_isnan
ldexp
log
_logb
log10
longjmp
_matherr
modf
_nextafter
pow
printf_s

printf
_scalb
scanf_s
scanf
setjmp
sin
sinh
sqrt
_status87, _statusfp
tan
tanh

Meskipun kode sumber tersedia untuk sebagian printf besar rutinitas dan scanf , kode tersebut melakukan panggilan internal ke rutinitas lain yang kode sumbernya tidak disediakan.

Rutinitas yang bertingkat berbeda dalam build debug aplikasi

Beberapa fungsi run-time C dan operator C++ berperilaku berbeda saat dipanggil dari build debug aplikasi. (Anda dapat membuat build debug aplikasi dengan menentukan _DEBUG bendera atau dengan menautkan dengan versi debug pustaka run-time C.) Perbedaan perilaku biasanya terdiri dari fitur atau informasi tambahan yang disediakan oleh rutinitas untuk mendukung proses debugging. Tabel berikut mencantumkan rutinitas ini.

Rutinitas C abort

Rutinitas C assert

Operator C++ delete

Operator C++ new

Baca juga

Rutinitas runtime Universal C menurut kategori
Pemeriksaan kesalahan runtime