/Yc (Datei der vorkompilierten Header erstellen)

  • Artikel

Weist den Compiler an, eine vorkompilierte Headerdatei (PCH) zu erstellen, die den Kompilierungsstatus an einem bestimmten Punkt darstellt.

Syntax

/Yc
/Yc-Dateiname

Argumente

filename
Gibt eine Headerdatei (H) an. Wenn dieses Argument verwendet wird, kompiliert der Compiler den gesamten Code bis einschließlich der H-Datei.

Hinweise

Wenn /Yc ohne Argument angegeben wird, kompiliert der Compiler den gesamten Code bis zum Ende der Basisquelldatei oder zum Punkt in der Basisdatei, an dem eine Hdrstop-Direktive auftritt. Die resultierende PCH-Datei hat den gleichen Basisnamen wie Ihre Basisquelldatei, es sei denn, Sie geben einen anderen Dateinamen unter Verwendung des hdrstop pragma oder der Option "/Fp " an.

Der vorkompilierte Code wird in einer Datei mit einem Namen gespeichert, der aus dem Basisnamen der Datei erstellt wurde, die mit der Option "/Yc " und der Erweiterung ".pch" angegeben wurde. Sie können auch die /Fp (Name) verwenden. Pch File) -Option, um einen Namen für die vorkompilierte Headerdatei anzugeben.

Wenn Sie den Dateinamen "/Yc" verwenden, kompiliert der Compiler den gesamten Code bis hin zur angegebenen Datei für die nachfolgende Verwendung mit der Option "/Yu" (Precompiled Header File verwenden).

Wenn die Optionen "/Yc"-Dateiname und "/Yu"-Dateiname in derselben Befehlszeile auftreten, und beide verweisen oder implizieren, hat derselbe Dateiname /Yc-DateinameVorrang. Dieses Feature vereinfacht das Schreiben von Makefiles.

Weitere Informationen zu vorkompilierten Headern finden Sie unter:

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

  1. Wählen Sie eine CPP-Datei aus. Die CPP-Datei muss die H-Datei #include, die vorkompilierte Headerinformationen enthält. Die Einstellung "/Yc" des Projekts kann auf Dateiebene überschrieben werden.

  2. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  3. Öffnen Sie die Eigenschaften "Konfigurationseigenschaften", "C/C++", "Precompiled Headers".Open the Configuration Properties, C/C++, Precompiled Headers property page.

  4. Ändern Sie die Precompiled Header-Eigenschaft .

  5. Ändern Sie zum Festlegen des Dateinamens die Eigenschaft "Precompiled Header File ".

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Betrachten Sie folgenden Code:

// prog.cpp
// compile with: cl /c /Ycmyapp.h prog.cpp
#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
// ...

Wenn dieser Code mit dem Befehl CL /YcMYAPP.H PROG.CPPkompiliert wird, speichert der Compiler alle Vorverarbeitungen für AFXWIN.h, RESOURCE.h und MYAPP.h in einer vorkompilierten Headerdatei namens MYAPP.pch.

Siehe auch

MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile
Vorkompilierte Headerdateien