{{tag>dev c cpp todo}}

====== Le préprocesseur ======

Le préprocesseur (de texte) est un programme s’exécutant avant la compilation. Il parcours le fichier source à la recherche de directives de précompilation (introduites par le caractères '#') qu'il traite et remplace.

===== Directive include =====

Lorsque le préprocesseur rencontre la directive **%%#include%%**, il insère littéralement le contenu du fichier indiqué à l'endroit du**%%#include%%**.


===== Directive define =====

Cette directive permet de définir une constante de préprocesseur. Cela permet d'associer une valeur à un mot:

<code c>
#define MAX_LENGTH 110
</code>

Dans cet exemple, lors de son exécution, le préprocesseur remplacera toutes les occurrences du mot **MAX_LENGTH** dans le fichier source par la valeur **110**.

On notera:
  * que la directive define a une **portée** qui s'étend à l'ensemble du **fichier**;
  * que la constante définie par la directive define n'occupe pas de place en mémoire contrairement à une définition du type %%const int MAX_LEGHT = 110;%%


<note>
Les constantes de préprocesseur permettent de "configurer" le programme avant sa compilation. C'est une sorte de mini-configuration. les directives "define" sont généralement placés dans des fichiers d' entête (.h), à proximité des prototypes.
</note>


===== Principaux usages =====

On utilise souvent les directives define pour donner une taille maximale à des tableaux ou buffers.

===== Bonnes pratiques =====

==== Inclusions infinies ====

Pour éviter les inclusions infinies, une bonne pratique consiste à systématiquement déclarer une constante lors de la première inclusion grâce à une condition. Si une autre inclusion est 

<code c file.h>
#ifndef FILE_H    // Si la constante n'a pas été définie le fichier n'a jamais été inclus
#define FILE_H    // On définit la constante pour que la prochaine fois le fichier ne soit plus inclus

/* Contenu de votre fichier .h (autres include, prototypes, define...) */

#endif           // FILE_H
</code>

===== Synthèse =====

  * Le préprocesseur est un programme qui analyse le code source et y effectue des modifications avant la compilation. Il travaille sur un fichier source et produit un fichier source.
  * L'instruction de préprocesseur **#include** insère le contenu d'un autre fichier.
  * L'instruction **#define** définit une constante de préprocesseur. Elle permet de remplacer un mot-clé par une valeur dans le code source.
  * Les macros sont des morceaux de code tout prêts définis à l'aide d'un **#define**. Ils peuvent accepter des paramètres.
  * Il est possible d'écrire des conditions en langage préprocesseur pour choisir ce qui sera compilé. On utilise notamment les mots-clés **#if**, **#elif** et **#endif**.
  * Pour éviter qu'un fichier.h ne soit inclus un nombre infini de fois, on le protège à l'aide d'une combinaison de constantes de préprocesseur et de conditions.
    
===== Références =====

  * https://openclassrooms.com/fr/courses/19980-apprenez-a-programmer-en-c/15954-le-preprocesseur