Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
Weist den Compiler an, die durch die Eingabeargumente angegebenen Headereinheiten zu erstellen. Der Compiler generiert Headereinheiten als IFC-Dateien (.ifcIFC).
Syntax
/exportHeader /headerName:angleheader-name
/exportHeader /headerName:quoteheader-name
/exportHeaderfull path to header file
Arguments
Das Argument ist /exportHeader eine /headerName Befehlszeilenoption, header-namedie den Namen der zu exportierenden Headerdatei angibt.
Bemerkungen
/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.
Examples
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.
Um die
/exportHeaderOption explizit in der IDE auf eine Datei anzuwenden, wählen Sie die Datei im 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.Legen Sie die Dropdownliste "Konfiguration" auf "Alle Konfigurationen" fest. Legen Sie die Dropdownliste "Plattform" auf "Alle Plattformen" fest.
Öffnen Sie die Seite "Konfigurationseigenschaften>C/C++>Advanced ".
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 (Erstellen einer Kopfzeileneinheit aus der angegebenen Kopfzeile)
/headerUnit (Verwenden der Kopfzeileneinheit IFC)
/reference (Verwenden des benannten Moduls IFC)
/translateInclude (Übersetzen von Direktiven in Importdirektiven)