comment pragma

Nesne dosyasına veya yürütülebilir dosyaya açıklama kaydı yerleştirir.

Sözdizimi

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

Açıklamalar

Açıklama türü , açıklama kaydının türünü belirten, aşağıda açıklanan önceden tanımlanmış tanımlayıcılardan biridir. İsteğe bağlı açıklama dizesi , bazı açıklama türleri için ek bilgi sağlayan bir dize değişmez değeridir. Açıklama dizesi bir dize değişmez değeri olduğundan, kaçış karakterleri, katıştırılmış tırnak işaretleri (") ve birleştirme kullanımında dize değişmez değerleri için tüm kurallara uyar.

derleyicisi

Derleyicinin adını ve sürüm numarasını nesne dosyasına yerleştirir. Bu açıklama kaydı bağlayıcı tarafından yoksayılır. Bu kayıt türü için bir açıklama dizesi parametresi sağlarsanız, derleyici bir uyarı oluşturur.

Lib

Nesne dosyasına kitaplık arama kaydı yerleştirir. Bu açıklama türüne, bağlayıcının aramasını istediğiniz kitaplığın adına (ve muhtemelen yoluna) sahip bir açıklama dizesi parametresi eşlik etmelidir. Kitaplık adı, nesne dosyasındaki varsayılan kitaplık arama kayıtlarını izler. Bağlayıcı, bu kitaplığı kullanarak belirtilmemiş /nodefaultlibolduğu sürece, komut satırında belirttiğiniz gibi arar. Aynı kaynak dosyaya birden çok kitaplık arama kaydı yerleştirebilirsiniz. Her kayıt, nesne dosyasında kaynak dosyada bulunan sırayla görüntülenir.

Varsayılan kitaplığın ve eklenen kitaplığın sırası önemliyse, anahtarla /Zl derlemek varsayılan kitaplık adının nesne modülüne yerleştirilmesini engeller. Daha sonra ikinci bir açıklama pragma , eklenen kitaplıktan sonra varsayılan kitaplığın adını eklemek için kullanılabilir. Bu pragma yönergelerle listelenen kitaplıklar, nesne modülünde kaynak kodda buldukları sırayla görünür.

bağlayıcı

Nesne dosyasına bir bağlayıcı seçeneği yerleştirir. Bu açıklama türünü, komut satırına geçirmek veya geliştirme ortamında belirtmek yerine bir bağlayıcı seçeneği belirtmek için kullanabilirsiniz. Örneğin, simgenin eklenmesini zorlamak için /include seçeneğini belirtebilirsiniz:

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

Bağlayıcı tanımlayıcısına yalnızca aşağıdaki (açıklama türü) bağlayıcı seçenekleri geçirilebilir:

kullanıcı

Nesne dosyasına genel bir açıklama yerleştirir. Açıklama dizesi parametresi, açıklamanın metnini içerir. Bu açıklama kaydı bağlayıcı tarafından yoksayılır.

Örnekler

Aşağıdakiler pragma bağlayıcının EMAPI'yi aramasına neden olur. Bağlama sırasında LIB kitaplığı. Bağlayıcı önce geçerli çalışma dizininde ve ardından LIB ortam değişkeninde belirtilen yolda arar.

#pragma comment( lib, "emapi" )

Aşağıdakiler pragma derleyicinin, derleyicinin adını ve sürüm numarasını nesne dosyasına yerleştirmesine neden olur:

#pragma comment( compiler )

Açıklama dizesi parametresi alan açıklamalar için, makro bir dize değişmez değerine genişletildiği sürece dize değişmez değeri kullanacağınız herhangi bir yerde makro kullanabilirsiniz. Ayrıca, dize değişmez değerlerinin ve dize değişmez değerlerine genişleten makroların herhangi bir bileşimini birleştirebilirsiniz. Örneğin, aşağıdaki deyim kabul edilebilir:

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

Ayrıca bkz.

Pragma yönergeleri ve __pragma ve _Pragma anahtar sözcükleri