Menggunakan File Sumber

  • Artikel

Mesin debugger mempertahankan jalur sumber, yang merupakan daftar direktori dan server sumber yang berisi file kode sumber yang terkait dengan target saat ini. Mesin debugger dapat mencari direktori dan server sumber ini untuk file sumber. Dengan bantuan file simbol, mesin debugger dapat mencocokkan baris dalam file sumber dengan lokasi di memori target.

Untuk gambaran umum penggunaan file sumber dengan debugger, lihat Penelusuran kesalahan dalam Mode Sumber. Untuk gambaran umum jalur sumber, lihat Jalur Sumber. Untuk gambaran umum penggunaan server sumber dari mesin debugger, lihat Menggunakan Server Sumber.

Jalur Sumber

Untuk menambahkan direktori atau server sumber ke jalur sumber, gunakan metode AppendSourcePath. Seluruh jalur sumber dikembalikan oleh GetSourcePath dan dapat diubah menggunakan SetSourcePath. Satu direktori atau server sumber dapat diambil dari jalur sumber menggunakan GetSourcePathElement.

Untuk menemukan file sumber yang relatif terhadap jalur sumber, gunakan FindSourceFile atau, untuk opsi yang lebih canggih saat menggunakan server sumber, gunakan FindSourceFileAndToken. FindSourceFileAndToken juga dapat digunakan bersama dengan GetSourceFileInformation untuk mengambil variabel yang terkait dengan file di server sumber.

Mencocokkan File Sumber dengan Kode dalam Memori

Mesin debugger menyediakan tiga metode untuk menemukan lokasi memori yang sesuai dengan baris dalam file sumber. Untuk memetakan satu baris kode sumber ke lokasi memori, gunakan GetOffsetByLine. Untuk mencari lokasi memori untuk lebih dari satu baris sumber atau untuk baris sumber terdekat, gunakan GetSourceEntriesByLine. Metode GetSourceFileLineOffsets akan mengembalikan lokasi memori setiap baris dalam file sumber.

Untuk melakukan operasi yang berlawanan dan menemukan baris file sumber yang cocok dengan lokasi di memori target, gunakan GetLineByOffset.

Catatan Hubungan antara lokasi memori dan baris dalam file sumber belum tentu satu-ke-satu. Dimungkinkan bagi satu baris kode sumber yang sesuai dengan beberapa lokasi memori dan untuk satu lokasi memori yang sesuai dengan beberapa baris kode sumber.