/P (Prétraiter jusqu'à un fichier)

  • Article

Prétraite les fichiers sources C et C++ et écrit la sortie prétraite dans un fichier.

Syntaxe

/P

Notes

Le fichier a le même nom de base que le fichier source et une extension .i. Dans le processus, toutes les directives de préprocesseur sont effectuées, les expansions de macros sont effectuées et les commentaires sont supprimés. Pour conserver les commentaires dans la sortie prétraite, utilisez l’option /C (Conserver les commentaires pendant le prétraitement) avec /P.

/P ajoute des #line directives à la sortie, au début et à la fin de chaque fichier inclus et autour des lignes supprimées par les directives de préprocesseur pour la compilation conditionnelle. Ces directives renumérotent les lignes du fichier prétraité. Par conséquent, les erreurs générées au cours des étapes ultérieures du traitement font référence aux numéros de ligne du fichier source d’origine plutôt qu’aux lignes du fichier prétraité. Pour supprimer la génération de #line directives, utilisez /EP (Préprocesseur pour stdout sans directives #line) ainsi que /P.

L’option /P supprime la compilation. Il ne produit pas de fichier .obj, même si vous utilisez /Fo (nom de fichier objet). Vous devez soumettre à nouveau le fichier prétraité pour la compilation. /P supprime également les fichiers de sortie des options /FA, /Fa et /Fm . Pour plus d’informations, consultez /FA, /Fa (Fichier de référencement) et /Fm (Nom Mapfile).

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de propriétés de configuration>C/C++>Préprocesseur.

  3. Modifiez la propriété Generate Preprocessed File .

Pour définir cette option du compilateur par programmation

Exemple

La ligne de commande suivante prétraiteADD.C, conserve les commentaires, ajoute #line des directives et écrit le résultat dans un fichier : ADD.I

CL /P /C ADD.C

Voir aussi

Options du compilateur MSVC
Syntaxe de la ligne de commande du compilateur MSVC
/Fi (Prétraiter le nom du fichier de sortie)