/P (Vorverarbeitung in eine Datei)

Verarbeitet C- und C++-Quelldateien und schreibt die vorverarbeitete Ausgabe in eine Datei.

Syntax

/P

Hinweise

Die Datei hat denselben Basisnamen wie die Quelldatei und die Erweiterung ".i". Dabei werden alle Präprozessordirektiven durchgeführt, Makroerweiterungen durchgeführt und Kommentare entfernt. Um Kommentare in der vorverarbeiteten Ausgabe beizubehalten, verwenden Sie die Option "/C" (Kommentare während der Vorverarbeitung beibehalten) zusammen mit "/P".

/P fügt #line der Ausgabe Direktiven am Anfang und Ende jeder enthaltenen Datei und um Zeilen hinzu, die von Präprozessordirektiven für die bedingte Kompilierung entfernt wurden. Diese Direktiven nummerieren die Zeilen der vorverarbeiteten Datei neu. Daher beziehen sich Fehler, die in späteren Verarbeitungsphasen generiert wurden, auf die Zeilennummern der ursprünglichen Quelldatei und nicht auf Zeilen in der vorverarbeiteten Datei. Um die Generierung von #line Direktiven zu unterdrücken, verwenden Sie /EP (Preprocess to stdout Without #line Direktiven) sowie /P.

Die Option "/P " unterdrückt die Kompilierung. Sie erzeugt keine OBJ-Datei, auch wenn Sie /Fo (Objektdateiname) verwenden. Sie müssen die vorverarbeitete Datei erneut zur Kompilierung übermitteln. /P unterdrückt auch die Ausgabedateien aus den Optionen "/FA", "/Fa" und "/Fm ". Weitere Informationen finden Sie unter /FA, /Fa (Listing File) und /Fm (Name Mapfile).

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 Konfigurationseigenschaftenseite>C/C++>-Präprozessoreigenschaft aus.

  3. Ändern Sie die Eigenschaft "Vorverarbeitete Datei generieren".

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Die folgenden BefehlszeilenvorverarbeitungenADD.C, behält Kommentare bei, fügt Direktiven hinzu #line und schreibt das Ergebnis in eine Datei: ADD.I

CL /P /C ADD.C

Siehe auch

MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile
/Fi (Ausgabedateinamen vorverarbeiten)