/reference (Adlandırılmış modül IFC kullanın)

Derleyiciye geçerli derleme için mevcut bir IFC'yi (.ifc) kullanmasını söyler.

Sözdizimi

/reference module-name=filename
/reference filename

Bağımsız değişkenler

filename
Önceden oluşturulmuş modül bilgileri olan IFC verilerini içeren dosyanın adı. Birden fazla modülü içeri aktarmak için her dosya için ayrı /reference bir seçenek ekleyin.

module-name
Dışarı aktarılan birincil modül arabirimi birim adının veya tam modül bölüm adının geçerli adı.

Açıklamalar

Çoğu durumda, proje sistemi bir çözüm içindeki modül bağımlılıklarını otomatik olarak keşfettiğinden bu anahtarı belirtmeniz gerekmez.

Derleyici /reference seçeneği, veya sonraki derleyici seçeneğini (örneğin/std:c++latest) etkinleştirmenizi /std:c++20 gerektirir. Bu /reference seçenek Visual Studio 2019 sürüm 16.10'dan itibaren kullanılabilir.

Bağımsız değişken bir olmadan isefilename, bağımsız değişkenin /reference belirli bir module-nameiçeri aktarmayı adlandırdığını doğrulamak filename için dosya çalışma zamanında açılır. Çok sayıda /reference bağımsız değişkeni olan senaryolarda çalışma zamanı performansının daha yavaş olmasıyla sonuçlanabilir.

geçerli module-name bir birincil modül arabirim birimi adı veya tam modül bölüm adı olmalıdır. Birincil modül arabirimi adları şunlardır:

  • M
  • M.N.O
  • MyModule
  • my_module

Tam modül bölüm adları şunlardır:

  • M:P
  • M.N.O:P.Q
  • MyModule:Algorithms
  • my_module:algorithms

Bir modül başvurusu kullanılarak module-nameoluşturulursa, derleyici bu adın içeri aktarılmasıyla karşılaşırsa, komut satırındaki diğer modüller aranamaz. Örneğin, şu komut satırı göz önünde bulundurulduğunda:

cl ... /std:c++latest /reference m.ifc /reference m=n.ifc

Yukarıdaki örnekte, derleyici görürse import m;m.ifc aranmıyor demektir.

Örnekler

Bu tabloda listelenen üç modül verilmiştir:

Modül IFC dosyası
M m.ifc
M:Part1 m-part1.ifc
Core.Networking Networking.ifc

Bağımsız değişken kullanan filename başvuru seçenekleri şöyle olacaktır:

cl ... /std:c++latest /reference m.ifc /reference m-part.ifc /reference Networking.ifc

kullanılan module-name=filename başvuru seçenekleri şöyle olacaktır:

cl ... /std:c++latest /reference m=m.ifc /reference M:Part1=m-part.ifc /reference Core.Networking=Networking.ifc

Ayrıca bkz.

/scanDependencies (Modül bağımlılıklarını standart biçimde listeleme)
/sourceDependencies:directives (Modül ve üst bilgi birimi bağımlılıklarını listeleme)
/headerUnit (IFC üst bilgi birimini kullan)
/exportHeader (Üst bilgi birimleri oluştur)