/E (Prétraiter dans stdout)

  • Article

Prétraite les fichiers sources C et C++ et copie les fichiers prétraités sur l’appareil de sortie standard.

Syntaxe

/E

Notes

Dans ce 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 également l’option du compilateur /C (Conserver les commentaires pendant le prétraitement).

/E 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é.

L’option /E supprime la compilation. Vous devez soumettre à nouveau le fichier prétraité pour la compilation. /E 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 supprimer des #line directives, utilisez l’option /EP (Préprocesseur pour stdout sans directives #line) à la place.

Pour envoyer la sortie prétraite à un fichier au lieu de le stdoutfaire, utilisez l’option /P (Prétraiter vers un fichier) à la place.

Pour supprimer des #line directives et envoyer la sortie prétraite à un fichier, utilisez /P et /EP ensemble.

Vous ne pouvez pas utiliser d’en-têtes précompilés avec l’option /E .

Notez que lors du prétraitement vers un fichier distinct, les espaces ne sont pas émis après les jetons. Cela peut entraîner un programme illégal ou avoir des effets secondaires inattendus. Le programme suivant se compile correctement :

#define m(x) x
m(int)main( )
{
   return 0;
}

Toutefois, si vous compilez avec :

cl -E test.cpp > test2.cpp

int main dans test2.cpp sera incorrectement intmain.

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 Propriétés de configuration>C/C++>Ligne de commande.

  3. Entrez l’option du compilateur dans la zone Options supplémentaires.

Pour définir cette option du compilateur par programmation

Exemple

Les prétraitements ADD.Cde ligne de commande suivants, conservent les commentaires, ajoutent #line des directives et affichent le résultat sur l’appareil de sortie standard :

CL /E /C ADD.C

Voir aussi

Options du compilateur MSVC
Syntaxe de la ligne de commande du compilateur MSVC