Share via


/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)