/exportHeader (Vytvoření jednotek záhlaví)

Říká kompilátoru, aby vytvořil jednotky záhlaví určené vstupními argumenty. Kompilátor generuje jednotky hlaviček jako soubory IFC (.ifc).

Syntaxe

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

Argumenty

Argumentem /exportHeader je možnost příkazového /headerName řádku, která určuje název souboru záhlaví, header-namekterý se má exportovat.

Poznámky

/exportHeader je k dispozici od sady Visual Studio 2019 verze 16.10.

Možnost /exportHeader kompilátoru vyžaduje povolení nebo novější možnost kompilátoru /std:c++20 (například /std:c++latest).

Jedna /exportHeader možnost kompilátoru může zadat tolik argumentů názvu hlavičky, kolik vyžaduje sestavení. Nemusíte je zadávat samostatně.

Kompilátor implicitně povolí nový preprocesor při použití této možnosti. To znamená, /Zc:preprocessor že je přidán do příkazového řádku kompilátorem, pokud se na příkazovém řádku používá nějaká /exportHeader forma. Pokud chcete vyjádřit výslovný nesouhlas s implicitní /Zc:preprocessor, použijte: /Zc:preprocessor-

Kompilátor ve výchozím nastavení negeneruje soubor objektu při kompilaci jednotky záhlaví. Chcete-li vytvořit soubor objektu, zadejte možnost kompilátoru /Fo . Další informace najdete v tématu /Fo (Název souboru objektu).a0>

Může být užitečné použít doplňkovou možnost /showResolvedHeader. Možnost /showResolvedHeader vytiskne absolutní cestu k souboru, na který header-name se argument přeloží.

/exportHeader dokáže zpracovat více vstupů najednou, a to i pod /MP. Doporučujeme, /ifcOutput <directory> abyste pro každou kompilaci vytvořili samostatný .ifc soubor.

Příklady

Pokud chcete vytvořit jednotku záhlaví, například <vector> by mohla vypadat takto:

cl . . . /std:c++latest /exportHeader /headerName:angle vector

Vytvoření hlavičky místního projektu, například "utils/util.h" může vypadat takto:

cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h

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

Tuto možnost byste obvykle neměli nastavit ve vývojovém prostředí sady Visual Studio, pokud pro soubory hlaviček nepoužíváte jiné rozšíření. Ve výchozím nastavení používá systém sestavení tuto možnost pro kompilované soubory, které mají příponu .h nebo žádné rozšíření.

1. Pokud chcete možnost použít /exportHeader u souboru explicitně v integrovaném vývojovém prostředí (IDE), vyberte soubor v Průzkumník řešení. Kliknutím pravým tlačítkem otevřete místní nabídku a výběrem možnosti Vlastnosti otevřete dialogové okno Stránky vlastností.

2. Nastavte rozevírací seznam Konfigurace na Všechny konfigurace. Nastavte rozevírací seznam Platformy na Všechny platformy.

3. Otevřete stránku vlastností konfigurace>C/C++>Advanced.

4. Pomocí ovládacího prvku rozevíracího seznamu upravte vlastnost Compile As na Compile as C++ Header Unit (/exportHeader). Změny uložíte kliknutím na OK nebo Použít .

Viz také

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