Защо не пишем код в заглавния файл?

Кодът в заглавните файлове (.h или .hpp в C++) не трябва да се поставя по следните причини:

1. Нарушение на правилото за една дефиниция (One Definition Rule - ODR). Когато няколко файла .cpp включват заглавен файл, съдържащ изпълним код, той ще бъде дефиниран повече от веднъж, което ще доведе до грешка при свързването (multiple definition). Изключение правят inline функциите и шаблоните на класове/функции, които трябва да бъдат дефинирани във всеки модул на превод, където се използват.

   // пример.h
   int g_counter = 0; // Глобална променлива - нарушение на ODR
   
   void my_function() { // Функция - нарушение на ODR
       // код
   }
   
   inline void my_inline_function() { // inline функция - изключение
       // код
   }
   
   template<typename T>
   void process(T value) { // шаблонна функция - изключение
       // код
   }
   

2. Увеличаване на времето за компилиране. Всеки път, когато се включи заглавен файл, компилаторът го обработва отново. Поставянето на код в заглавните файлове увеличава натоварването на компилатора и забавя процеса на сглобяване на проекта, особено в големи проекти.

3. Усложнение при поддръжката и тестването. Кодът, разпръснат по заглавните файлове, става по-малко модулен. Това усложнява тестването на отделни компоненти и тяхната независима промяна.

4. Риск от циклични включвания (include loops). Неправилната организация на включванията с код в заглавните файлове може да доведе до циклични зависимости и проблеми с компилацията.

В заглавните файлове обикновено се обявяват:

• Класове (определения, но не реализации на методи)
• Функции (прототипи)
• Глобални променливи (с използване на extern)
• Константи
• Шаблони на класове и функции (пълни определения)
• inline функции (пълни определения)
• Типове данни (struct, enum, typedef, using)
• Пространства имена (namespace)

Реализацията на кода (тялото на функциите, определенията на статичните членове на класове и глобалните променливи) се поставя в съответните файлове за реализация (.cpp).