.printf

Token .printf berulah seperti pernyataan printf di C.

.printf [/D] [Option] "FormatString" [, Argument , ...] 

Elemen Sintaks

/D
Menentukan bahwa string format berisi Debugger Markup Language (DML).

Pilihan
(Hanya WinDbg) Menentukan jenis pesan teks yang harus ditafsirkan WinDbg sebagai FormatString. WinDbg menetapkan setiap jenis pesan jendela Perintah Debugger latar belakang dan warna teks; memilih salah satu opsi ini menyebabkan pesan ditampilkan dalam warna yang sesuai. Defaultnya adalah menampilkan teks sebagai pesan tingkat normal.

Opsi berikut tersedia.

Opsi	Jenis pesan	Judul warna dalam kotak dialog Opsi
/Od	debuggee	Jendela perintah tingkat debuggee
/Od	perintah debuggee	Jendela perintah tingkat prompt debuggee
/Oe	kesalahan	Jendela perintah tingkat kesalahan
/Pada	normal	Jendela perintah tingkat normal
/Op	permintaan	Jendela perintah tingkat perintah
/Op	prompt registers	Jendela perintah tingkat prompt registers
/Os	Simbol	Jendela perintah tingkat pesan simbol
/Ov	verbose	Jendela perintah tingkat verbose
/Ow	peringatan	Jendela perintah tingkat peringatan

FormatString
Menentukan string format, seperti dalam printf. Secara umum, karakter konversi berfungsi persis seperti di C. Untuk karakter konversi floating-point, argumen 64-bit ditafsirkan sebagai angka floating-point 32-bit kecuali jika pengubah l digunakan.

Pengubah "I64" dapat ditambahkan untuk menunjukkan bahwa nilai harus ditafsirkan sebagai 64-bit. Misalnya, "%I64x" dapat digunakan untuk mencetak angka heksadesimal 64-bit.

Karakter konversi %p didukung, tetapi mewakili penunjuk di ruang alamat virtual target. Ini tidak boleh memiliki pengubah dan menggunakan pemformatan alamat internal debugger. Selain penentu format gaya cetak standar, karakter konversi tambahan berikut didukung.

Karakter	Jenis Argumen	Argumen	Teks dicetak
%p	ULONG64	Penunjuk di ruang alamat virtual target.	Nilai penunjuk.
%N	DWORD_PTR (32 atau 64 bit, tergantung pada arsitektur host)	Penunjuk di ruang alamat virtual host.	Nilai penunjuk. (Ini setara dengan karakter C %p standar.)
%ma	ULONG64	Alamat string ASCII yang dihentikan NULL di ruang alamat virtual target.	String yang ditentukan.
%mu	ULONG64	Alamat string Unicode yang dihentikan NULL di ruang alamat virtual target.	String yang ditentukan.
%msa	ULONG64	Alamat struktur ANSI_STRING di ruang alamat virtual target.	String yang ditentukan.
%msu	ULONG64	Alamat struktur UNICODE_STRING di ruang alamat virtual target.	String yang ditentukan.
%y	ULONG64	Alamat simbol debugger di ruang alamat virtual target.	String yang berisi nama simbol yang ditentukan (dan perpindahan, jika ada).
%ly	ULONG64	Alamat simbol debugger di ruang alamat virtual target.	String yang berisi nama simbol yang ditentukan (dan perpindahan, jika ada), serta informasi baris sumber yang tersedia.

Argumen
Menentukan argumen untuk string format, seperti dalam printf. Jumlah argumen yang ditentukan harus cocok dengan jumlah karakter konversi dalam FormatString. Setiap argumen adalah ekspresi yang akan dievaluasi oleh evaluator ekspresi default (MASM atau C++). Untuk detailnya, lihat Sintaks Ekspresi Numerik.

Informasi Tambahan

Untuk informasi tentang token alur kontrol lainnya dan penggunaannya dalam program perintah debugger, lihat Menggunakan Program Perintah Debugger.

Keterangan

Pengaturan warna yang dapat Anda pilih dengan menggunakan parameter Opsi secara default diatur ke teks hitam di latar belakang putih. Untuk memanfaatkan opsi ini dengan semaksimur mungkin, Anda harus terlebih dahulu menggunakan Tampilan | Opsi untuk membuka kotak dialog Opsi dan mengubah pengaturan warna untuk pesan jendela Perintah Debugger.

Contoh berikut menunjukkan cara menyertakan tag DML dalam string format.

.printf /D "Click <link cmd=\".chain /D\">here</link> to see extensions DLLs."

Output yang ditampilkan dalam gambar sebelumnya memiliki tautan yang dapat Anda klik untuk menjalankan perintah yang ditentukan dalam <link> tag. Gambar berikut menunjukkan hasil mengklik tautan.

Untuk informasi tentang tag DML, lihat dml.doc di folder penginstalan untuk Alat Debugging untuk Windows.