Share via

/headerUnit (Použití hlavičkové jednotky IFC)

  • Článek

Importuje jednotku záhlaví. Říká kompilátoru, kde má najít .ifc soubor (binární reprezentace jednotky hlavičky) pro zadanou hlavičku.

Syntaxe

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

Argumenty

header-filename
Během import header-name; kompilátoru se překládá header-name na soubor na disku. Slouží header-filename k zadání daného souboru. Po spárování kompilátor otevře odpovídající IFC pojmenovaný ifc-filename pro import.

ifc-filename
Název souboru, který obsahuje zkompilované informace o jednotce záhlaví. Pokud chcete importovat více než jednu jednotku záhlaví, přidejte pro každý soubor samostatnou /headerUnit možnost.

Poznámky

Možnost kompilátoru /headerUnit vyžaduje /std:c++20 nebo novější.

Možnost kompilátoru /headerUnit je dostupná v sadě Visual Studio 2019 verze 16.10 nebo novější.

Když kompilátor narazí import "file"; nebo import <file>; tato možnost kompilátoru pomůže kompilátoru najít zkompilovanou jednotku hlavičky (.ifc) pro zadaný soubor hlaviček. Cestu k tomuto souboru lze vyjádřit těmito způsoby:

  • /headerUnit vyhledá zkompilovanou jednotku hlavičky v aktuálním adresáři nebo v umístění určeném ifc-filenamenástrojem .

  • /headerUnit:quote vyhledá zkompilovaný soubor jednotky hlaviček pomocí stejných pravidel jako #include "file".

  • /headerUnit:angle vyhledá zkompilovaný soubor jednotky hlaviček pomocí stejných pravidel jako #include <file>.

Kompilátor nemůže namapovat jeden header-name na více .ifc souborů. Mapování více header-name argumentů na jeden .ifc je možné, ale nedoporučuje se. Obsah se .ifc naimportuje, jako by to byla pouze hlavička určená header-name.

Kompilátor implicitně povolí nový preprocesor při použití této možnosti. Pokud je na příkazovém řádku zadána nějaká forma /headerUnit , /Zc:preprocessor kompilátor ji přidá do příkazového řádku. Pokud se chcete z implicitního /Zc:preprocessornastavení odhlásit, zadejte: /Zc:preprocessor-

Pokud nový preprocesor zakážete, ale soubor, který zkompilujete, importuje jednotku hlaviček, kompilátor oznámí chybu.

Příklady

Vzhledem k projektu, který odkazuje na dva soubory hlaviček a jejich jednotky záhlaví, jak je uvedeno v této tabulce:

Hlavičkový soubor Soubor IFC
C:\utils\util.h C:\util.h.ifc
C:\app\app.h C:\app\app.h.ifc

Možnosti kompilátoru odkazování na jednotky hlaviček pro tyto konkrétní soubory hlaviček by vypadaly takto:

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

Nastavení tohoto parametru kompilátoru ve vývojovém prostředí Visual Studio

Obvykle byste to neměli nastavit ve vývojovém prostředí sady Visual Studio. Nastavuje ho systém sestavení.

Viz také

/exportHeader (Vytvoření jednotek záhlaví)
/headerName (Vytvoření jednotky záhlaví ze zadané hlavičky)
/reference (Použití pojmenovaného modulu IFC)
/translateInclude (Přeložit direktivy include do direktiv importu)