Preprocessor

Le préprocesseur est exécuté lors de la phase de traduction 4 , avant la compilation. Le résultat du préprocessing est un fichier unique qui est ensuite transmis au compilateur proprement dit.

Table des matières 1 Directives 2 Capacités 3 Notes de bas de page 4 Exemple 5 Références 6 Voir aussi

Directives

Les directives de préprocesseur contrôlent le comportement du préprocesseur. Chaque directive occupe une ligne et a le format suivant :

• # caractère
• instruction de préprocesseur (l'une des suivantes : define , undef , include , if , ifdef , ifndef , else , elif , elifdef , elifndef (depuis C23) , endif , line , embed (depuis C23) , error , warning (depuis C23) , pragma ) ^[1]
• arguments (dépend de l'instruction)
• saut de ligne.

La directive nulle ( # suivie d'un saut de ligne) est autorisée et n'a aucun effet.

Capacités

Le préprocesseur possède les capacités de traduction des fichiers sources :

• compilation conditionnelle de parties du fichier source (contrôlée par les directives #if , #ifdef , #ifndef , #else , #elif , #elifdef , #elifndef (depuis C23) et #endif ).
• remplacement de macros textuelles avec concaténation ou guillemetage d'identifiants (contrôlé par les directives #define et #undef , et les opérateurs # et ## )
• inclusion d'autres fichiers (contrôlée par la directive #include et vérifiée avec __has_include (depuis C23) )
• provoquer une erreur ou un avertissement (depuis C23) (contrôlé par la directive #error ou #warning respectivement (depuis C23) )

Les aspects suivants du préprocesseur peuvent être contrôlés :

• comportement défini par l'implémentation (contrôlé par la directive #pragma et l'opérateur _Pragma (depuis C99) )
• nom de fichier et informations de ligne disponibles pour le préprocesseur (contrôlé par les directives #line )

Notes de bas de page

1. ↑ Ce sont les directives définies par la norme. La norme ne définit pas le comportement pour d'autres directives : elles peuvent être ignorées, avoir une signification utile ou rendre le programme mal formé. Même si elles sont autrement ignorées, elles sont supprimées du code source lorsque le préprocesseur a terminé. Une extension non standard courante est la directive #warning qui émet un message défini par l'utilisateur pendant la compilation. (jusqu'à C23)

Exemple

Cette section est incomplète Raison : aucun exemple

Références

Voir aussi

Documentation C pour Symboles de Macro Prédéfinis

Documentation C pour Index des Symboles de Macro

Documentation C++ pour Préprocesseur