/exportHeader (Kopfzeileneinheiten erstellen)

  • Artikel

Weist den Compiler an, die durch die Eingabeargumente angegebenen Headereinheiten zu erstellen. Der Compiler generiert Headereinheiten als IFC-Dateien (.ifcIFC).

Syntax

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

Argumente

Das Argument ist /exportHeader eine /headerName Befehlszeilenoption, header-namedie den Namen der zu exportierenden Headerdatei angibt.

Hinweise

/exportHeader ab Visual Studio 2019, Version 16.10, verfügbar.

Für die /exportHeader Compileroption müssen Sie die /std:c++20 Compileroption (z /std:c++latest. B. ) aktivieren.

Eine /exportHeader Compileroption kann beliebig viele Headernamenargumente angeben, wie für den Build erforderlich ist. Sie müssen sie nicht separat angeben.

Der Compiler aktiviert implizit den neuen Präprozessor, wenn diese Option verwendet wird. Das heißt, wird der Befehlszeile vom Compiler hinzugefügt, /Zc:preprocessor wenn eine beliebige Form von /exportHeader in der Befehlszeile verwendet wird. Um die implizite /Zc:preprocessorDeaktivierung zu deaktivieren, verwenden Sie Folgendes: /Zc:preprocessor-

Standardmäßig erzeugt der Compiler keine Objektdatei, wenn eine Headereinheit kompiliert wird. Um eine Objektdatei zu erzeugen, geben Sie die /Fo Compileroption an. Weitere Informationen finden Sie unter /Fo (Objektdateiname).

Möglicherweise ist es hilfreich, die ergänzende Option /showResolvedHeaderzu verwenden. Die /showResolvedHeader Option druckt einen absoluten Pfad zur Datei, in den das header-name Argument aufgelöst wird.

/exportHeader kann mehrere Eingaben gleichzeitig verarbeiten, auch unter /MP. Es wird empfohlen /ifcOutput <directory> , für jede Kompilierung eine separate .ifc Datei zu erstellen.

Beispiele

So erstellen Sie eine Kopfzeileneinheit wie <vector> folgt:

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

Erstellen eines lokalen Projektheaders, "utils/util.h" z. B. wie folgt:

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

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

Normalerweise sollten Sie diese Option in der Visual Studio-Entwicklungsumgebung nicht festlegen, es sei denn, Sie verwenden eine andere Erweiterung für Ihre Headerdateien. Standardmäßig wendet das Buildsystem diese Option auf kompilierte Dateien an, die über eine .h Erweiterung oder keine Erweiterung verfügen.

  1. Wenn Sie die /exportHeader Option explizit in der IDE auf eine Datei anwenden möchten, wählen Sie die Datei in Projektmappen-Explorer aus. Klicken Sie mit der rechten Maustaste, um das Kontextmenü zu öffnen, und wählen Sie "Eigenschaften" aus, um das Dialogfeld "Eigenschaftenseiten" zu öffnen.

  2. Legen Sie die Dropdownliste "Konfiguration " auf " Alle Konfigurationen" fest. Legen Sie die Dropdownliste "Plattform" auf " Alle Plattformen" fest.

  3. Öffnen Sie die Seite "Konfigurationseigenschaften>C/C++>Advanced".

  4. Verwenden Sie das Dropdownsteuerelement, um die Compile As-Eigenschaft so zu ändern, dass sie als C++-Headereinheit (/exportHeader) kompiliert wird. Wählen Sie OK oder Übernehmen, um die Änderungen zu speichern.

Siehe auch

/headerName (Headereinheit aus angegebenem Header erstellen)
/headerUnit (Verwenden der Headereinheit IFC)
/reference (Verwenden des benannten Moduls IFC)
/translateInclude (Übersetzen von include-Anweisungen in import-Anweisungen)