/headerUnit (IFC üst bilgi birimini kullan)

Üst bilgi birimini içeri aktarır. Derleyiciye, belirtilen üst bilgi için dosyanın nerede bulunacağı .ifc (üst bilgi biriminin ikili gösterimi) bildirir.

Sözdizimi

/headerUnit header-filename=ifc-filename
/headerUnit:quote [header-filename=ifc-filename]
/headerUnit:angle [header-filename=ifc-filename]

Bağımsız değişkenler

header-filename
Derleyici disk üzerindeki bir dosyaya çözümlenirken import header-name;header-name . Bu dosyayı belirtmek için kullanın header-filename . Eşleştirildikten sonra, derleyici içeri aktarma için tarafından adlı karşılık gelen IFC'yi ifc-filename açar.

ifc-filename
Derlenmiş üst bilgi birimi bilgilerini içeren bir dosyanın adı. Birden fazla üst bilgi birimini içeri aktarmak için her dosya için ayrı /headerUnit bir seçenek ekleyin.

Açıklamalar

Derleyici /headerUnit seçeneği veya üzerini /std:c++20 gerektirir.

/headerUnit Derleyici seçeneği Visual Studio 2019 sürüm 16.10 veya sonraki sürümlerde kullanılabilir.

Derleyici karşı karşıya import "file"; geldiğinde veya import <file>; bu derleyici seçeneği derleyicinin belirtilen üst bilgi dosyası için derlenmiş üst bilgi birimini (.ifc) bulmasına yardımcı olur. Bu dosyanın yolu şu yollarla ifade edilebilir:

  • /headerUnit derlenmiş üst bilgi birimini geçerli dizinde veya tarafından ifc-filenamebelirtilen konumda arar.

  • /headerUnit:quote ile aynı kuralları #include "file"kullanarak derlenmiş üst bilgi birimi dosyasını arar.

  • /headerUnit:angle ile aynı kuralları #include <file>kullanarak derlenmiş üst bilgi birimi dosyasını arar.

Derleyici tek bir header-name dosyayı birden çok .ifc dosyayla eşleyemez. Birden çok header-name bağımsız değişkeni tek .ifc bir bağımsız değişkenle eşlemek mümkündür, ancak önerilmez. içindekiler .ifc , yalnızca tarafından header-namebelirtilen üst bilgi gibi içeri aktarılır.

Derleyici, bu seçenek kullanıldığında yeni ön işlemciyi örtük olarak etkinleştirir. Komut satırında herhangi bir biçimi /headerUnit belirtilirse, /Zc:preprocessor derleyici tarafından komut satırına eklenir. Örtük /Zc:preprocessorseçeneğini geri çevirmek için şunu belirtin: /Zc:preprocessor-

Yeni ön işlemciyi devre dışı bırakırsanız ancak derlediğiniz bir dosya bir üst bilgi birimini içeri aktarırsa, derleyici bir hata bildirir.

Örnekler

Bu tabloda listelendiği gibi iki üst bilgi dosyası ve bunların üst bilgi birimlerine başvuran bir proje verilmiştir:

Üst bilgi dosyası IFC dosyası
C:\utils\util.h C:\util.h.ifc
C:\app\app.h C:\app\app.h.ifc

Bu belirli üst bilgi dosyaları için üst bilgi birimlerine başvurmak için derleyici seçenekleri şöyle görünür:

cl ... /std:c++latest /headerUnit C:\utils\util.h=C:\util.h.ifc /headerUnit:quote app.h=app.h.ifc

Bu derleyici seçeneğini Visual Studio geliştirme ortamında ayarlamak için

Normalde bunu Visual Studio geliştirme ortamında ayarlamamalısınız. Derleme sistemi tarafından ayarlanır.

Ayrıca bkz.

/exportHeader (Üst bilgi birimleri oluştur)
/headerName (Belirtilen üst bilgiden üst bilgi birimi oluşturma)
/reference (Adlandırılmış modül IFC kullanın)
/translateInclude (Include yönergelerini içeri aktarma yönergelerine çevirin)