Pourquoi n'écrivons-nous pas de code dans le fichier d'en-tête?

Le code dans les fichiers d'en-tête (.h ou .hpp en C++) ne doit pas être placé pour les raisons suivantes :

1. Violation du principe d'une seule définition (One Definition Rule - ODR). Lorsqu'un fichier .h est inclus dans plusieurs fichiers .cpp, le code exécutable qu'il contient sera défini plusieurs fois, ce qui entraînera une erreur de liaison (définition multiple). L'exception concerne les fonctions inline et les modèles de classes/fonctions, qui doivent être définis dans chaque module de traduction où ils sont utilisés.

   // exemple.h
   int g_counter = 0; // Variable globale - violation de l'ODR
   
   void my_function() { // Fonction - violation de l'ODR
       // code
   }
   
   inline void my_inline_function() { // fonction inline - exception
       // code
   }
   
   template<typename T>
   void process(T value) { // modèle de fonction - exception
       // code
   }
   

2. Augmentation du temps de compilation. Chaque inclusion d'un fichier d'en-tête oblige le compilateur à traiter son contenu à nouveau. Placer du code dans les fichiers d'en-tête augmente la charge pour le compilateur, ralentissant le processus de construction du projet, surtout dans les grands projets.

3. Complexité de maintenance et de test. Le code dispersé dans les fichiers d'en-tête devient moins modulaire. Cela complique le test des composants individuels et leur modification indépendante.

4. Risque de boucles d'inclusion (include loops). Une organisation incorrecte des inclusions avec du code dans les fichiers d'en-tête peut conduire à des dépendances cycliques et à des problèmes de compilation.

Dans les fichiers d'en-tête, on déclare généralement :

• Classes (définitions, mais pas implémentations de méthodes)
• Fonctions (prototypes)
• Variables globales (avec extern)
• Constantes
• Modèles de classes et de fonctions (définitions complètes)
• Fonctions inline (définitions complètes)
• Types de données (struct, enum, typedef, using)
• Espaces de noms (namespace)

L'implémentation du code (corps des fonctions, définitions des membres statiques de classe et variables globales) est placée dans les fichiers d'implémentation appropriés (.cpp).