/Fp (Name.pch-Datei)

  • Artikel

Stellt einen Pfadnamen für einen vorkompilierten Header bereit, anstatt den Standardpfadnamen zu verwenden.

Syntax

/Fp-Pfadname

Hinweise

Verwenden Sie die Option /FP mit /Yc (Precompiled Header File erstellen) oder /Yu (Precompiled Header File verwenden), um den Pfad und Dateinamen für die vorkompilierte Headerdatei (PCH) anzugeben. Standardmäßig erstellt die Option "/Yc " einen PCH-Dateinamen mithilfe des Basisnamens der Quelldatei und einer PCH-Erweiterung .

Wenn Sie keine Erweiterung als Teil des Pfadnamens angeben, wird eine Erweiterung von pch angenommen. Wenn Sie einen Verzeichnisnamen mithilfe eines Schrägstrichs (/) am Ende des Pfadnamens angeben, lautet der Standarddateiname vcVersion0.pch, wobei die Version die Hauptversion des Visual Studio-Toolsets ist. Dieses Verzeichnis muss vorhanden sein, oder fehler C1083 wird generiert.

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

  1. Ö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).

  2. Wählen Sie die Eigenschaftenseite "Konfigurationseigenschaften>C/C++>Precompiled Headers" aus.

  3. Ändern Sie die Eigenschaft " Vorkompilierte Headerausgabedatei ".

So legen Sie diese Compileroption programmgesteuert fest

Beispiele

Um eine separate benannte Version der vorkompilierten Headerdatei für den Debugbuild Ihres Programms zu erstellen, können Sie einen Befehl wie:

CL /DDEBUG /Zi /Yc /FpDPROG.PCH PROG.CPP

Der folgende Befehl gibt die Verwendung einer vorkompilierten Headerdatei namens MYPCH.pch an. Der Compiler kompiliert den Quellcode in PROG.cpp bis zum Ende von MYAPP.h und fügt den vorkompilierten Code in MYPCH.pch ein. Anschließend wird der Inhalt von MYPCH.pch verwendet und der Rest von PROG.cpp kompiliert, um eine OBJ-Datei zu erstellen. Die Ausgabe dieses Beispiels ist eine Datei mit dem Namen PROG.exe.

CL /YuMYAPP.H /FpMYPCH.PCH PROG.CPP

Siehe auch

Ausgabedatei (/F) Optionen
MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile
Festlegen des Pfadnamens