/Yc (Datei der vorkompilierten Header erstellen)

  • Artikel

Aktualisiert: November 2007

Durch diese Option wird der Compiler angewiesen, eine vorkompilierte Headerdatei (PCH-Datei) zu erstellen, die den Kompilierungszustand an einem gewissen Punkt darstellt.

/Yc[filename]

Argumente

  • filename
    Gibt eine Headerdatei (H-Datei) 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 bis zu einer Stelle in der Quelldatei, an der hdrstop auftritt. Die erzeugte PCH-Datei hat denselben Basisnamen wie die Basisquelldatei, es sei denn, Sie geben mithilfe des hdrstop-Pragmas oder der /Fp-Option einen anderen Dateinamen an.

Der vorkompilierte Code wird in einer Datei gespeichert, deren Namen aus dem Basisnamen der durch die /Yc-Option angegebenen Datei und der Erweiterung .pch gebildet wird. Sie können auch die /Fp (Name der PCH-Datei)-Option zur Angabe eines Namens für die vorkompilierte Headerdatei verwenden.

Wenn Sie /Ycfilename verwenden, kompiliert der Compiler den gesamten Code bis einschließlich der zur nachfolgenden Verwendung mit der /Yu-Option angegebenen Datei.

Wenn die /Ycfilename-Option und die /Yu (Vorkompilierte Headerdatei verwenden)filename-Option in derselben Befehlszeile auftreten und auf denselben Dateinamen verweisen oder diesen implizieren, hat /Ycfilename Vorrang. Diese Funktion 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 H-Datei, die die vorkompilierten Headerinformationen enthält, muss in der CPP-Datei mit #include eingeschlossen werden. Die /Yc-Einstellung des Projekts kann auf Dateiebene überschrieben werden.

  2. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Gewusst wie: Öffnen von Projekteigenschaftenseiten.

  3. Klicken Sie auf den Ordner C/C++.

  4. Klicken Sie auf die Eigenschaftenseite Vorkompilierte Header.

  5. Ändern Sie die Eigenschaft PCH durch Datei erstellen oder Erstellen/Verwenden eines vorkompilierten Headers.

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Betrachten Sie folgenden Code:

#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
...

Wenn der Code mit dem CL /YcMYAPP.H PROG.CPP-Befehl kompiliert wird, wird vom Compiler die gesamte Vorverarbeitung für AFXWIN.h, RESOURCE.h und MYAPP.h in einer vorkompilierten Headerdatei mit dem Namen MYAPP.pch gespeichert.

Siehe auch

Referenz

Compileroptionen

Festlegen von Compileroptionen