comment pragma

Tempatkan rekaman komentar ke dalam file objek atau file yang dapat dieksekusi.

Sintaks

#pragma comment(comment-type [ , "comment-string" ] )

Keterangan

Jenis komentar adalah salah satu pengidentifikasi yang telah ditentukan sebelumnya, yang dijelaskan di bawah ini, yang menentukan jenis catatan komentar. String komentar opsional adalah string literal yang menyediakan informasi tambahan untuk beberapa jenis komentar. Karena string komentar adalah string harfiah, string mematuhi semua aturan untuk string literal tentang penggunaan karakter escape, tanda kutip yang disematkan ("), dan perangkaian.

compiler

Tempatkan nama dan nomor versi pengkompilasi dalam file objek. Rekaman komentar ini diabaikan oleh linker. Jika Anda memberikan parameter string komentar untuk jenis catatan ini, pengkompilasi akan menghasilkan peringatan.

Lib

Tempatkan rekaman pencarian pustaka dalam file objek. Jenis komentar ini harus disertai dengan parameter string komentar yang memiliki nama (dan mungkin jalur) pustaka yang Anda inginkan untuk dicari oleh linker. Nama pustaka mengikuti rekaman pencarian pustaka default dalam file objek. Linker mencari pustaka ini dengan cara yang sama seperti jika Anda menentukannya pada baris perintah, selama pustaka tidak ditentukan dengan menggunakan /nodefaultlib. Anda dapat menempatkan beberapa rekaman pencarian pustaka dalam file sumber yang sama. Setiap rekaman muncul dalam file objek dalam urutan yang sama yang ditemukan dalam file sumber.

Jika urutan pustaka default dan pustaka yang ditambahkan penting, mengkompilasi dengan sakelar /Zl akan mencegah nama pustaka default ditempatkan dalam modul objek. Komentar pragma kedua kemudian dapat digunakan untuk menyisipkan nama pustaka default setelah pustaka yang ditambahkan. Pustaka yang tercantum dengan arahan ini pragma akan muncul dalam modul objek dalam urutan yang sama yang ditemukan dalam kode sumber.

Linker

Tempatkan opsi linker dalam file objek. Anda dapat menggunakan jenis komentar ini untuk menentukan opsi linker alih-alih meneruskannya ke baris perintah atau menentukannya di lingkungan pengembangan. Misalnya, Anda dapat menentukan opsi /include untuk memaksa penyertaan simbol:

#pragma comment(linker, "/include:__mySymbol")

Hanya opsi linker (jenis komentar) berikut yang tersedia untuk diteruskan ke pengidentifikasi linker:

• /DEFAULTLIB

• /EXPORT

• /INCLUDE

• /MANIFESTDEPENDENCY

• /MERGE

• /SECTION

pengguna

Tempatkan komentar umum dalam file objek. Parameter string komentar berisi teks komentar. Rekaman komentar ini diabaikan oleh linker.

Contoh

Berikut ini pragma menyebabkan linker mencari EMAPI. Pustaka LIB saat menautkan. Linker mencari terlebih dahulu di direktori kerja saat ini, lalu di jalur yang ditentukan dalam variabel lingkungan LIB.

#pragma comment( lib, "emapi" )

Berikut ini pragma menyebabkan pengkompilasi menempatkan nama dan nomor versi pengkompilasi dalam file objek:

#pragma comment( compiler )

Untuk komentar yang mengambil parameter string komentar, Anda dapat menggunakan makro di tempat mana pun Anda akan menggunakan string literal, selama makro meluas ke string literal. Anda juga dapat menggabungkan kombinasi literal string dan makro yang diperluas untuk merangkai literal. Misalnya, pernyataan berikut dapat diterima:

#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )

Baca juga

Arahan Pragma dan __pragma_Pragma kata kunci