/headerName (Sestavení jednotky záhlaví ze zadané hlavičky)

Sestavte zadaný soubor hlaviček do jednotky záhlaví (.ifc souboru).

Syntaxe

/headerName:quote header-filename
/headerName:angle header-filename

Argumenty

header-filename
Název souboru hlaviček, který by měl kompilátor zkompilovat do jednotky hlavičky (.ifc souboru).

Poznámky

Možnosti a /headerName:angle možnosti kompilátoru /headerName:quote jsou dostupné od sady Visual Studio 2019 verze 16.10.

Možnosti kompilátoru /headerName ve všech jejich formulářích vyžadují možnost kompilátoru /std:c++20 nebo novější (například /std:c++latest).
Pokud zadáte /headerName možnost, musíte také zadat /exportHeader.

• /headerName:quote vyhledá header-filename stejná pravidla jako #include "header-filename" a sestaví ji jako jednotku hlavičky (.ifc soubor).
• /headerName:angle vyhledá header-filename stejná pravidla jako #include <header-filename> a sestaví ji jako jednotku hlavičky (.ifc soubor).

Další informace o pravidlech hledání cest pro zahrnuté soubory v uvozovkách nebo úhlových závorkách naleznete v direktivě#include.

Příklady

Vzhledem k projektu, který odkazuje na hlavičkový soubor, který definuje, je možnost m.hkompilátoru zkompilovat do jednotky záhlaví podobná tomuto příkladu:

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

/headerName:angle Možnosti /headerName:quote fungují jako příznak a nepotřebují argument. Následující příklady jsou platné:

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

Na stejném příkazovém řádku můžete zadat více /headerName možností. Každý argument po zpracování /headerName možnosti se zadaným vyhledávacím pravidlem souboru pro uvozovky nebo úhlové závorky až do další /headerName možnosti. Následující příklad zpracuje všechny hlavičky jako předchozí dva příklady příkazového řádku stejným způsobem jako předtím. Vyhledá hlavičky pomocí vyhledávacích pravidel použitých jako #include <vector>: , #include <iostream>, #include <algorithm>, #include "my-utilties.h"a #include "a/b/my-core.h":

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

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

Poznámka:

Tuto možnost byste normálně neměli nastavit ve vývojovém prostředí sady Visual Studio. Nastavuje ho systém sestavení.

1. Otevřete dialogové okno Stránky vlastností projektu. Podrobnosti najdete v tématu Nastavení kompilátoru C++ a vlastností sestavení v sadě Visual Studio.

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

3. Vyberte stránku vlastností příkazového řádku C/C++>Vlastnosti>konfigurace.

4. Upravte vlastnost Další možnosti tak, aby se přidaly /headerName:quote možnosti nebo /headerName:angle možnosti a názvy hlaviček, na které se možnosti vztahují. Pak zvolte OK nebo Použít a uložte provedené změny.

Viz také

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