caxapa.ru :: Поделитесь как удобно организовать хедеры .h в проекте на С? Есть около 5 модулей, у каждого есть функции и переменные видимые как extern, и есть только для внутреннего использования в модуле. Есть #define с константами. Хочется все записать в .h каждого модуля для простоты и подключать куда надо. Но пока делю

добавлю полезность. abivan(531 знак., 28.05.2024 12:10, ссылка)

Вообще-то h-файл это макроподстановка (дословно) в текст модуля, который импортирует объекты. Компилировать h-файл нет ни малейшего смысла. Он ЛИНКЕРУ не нужен. С рекурсией лучше бороться путем применения собственной головы и просто ее не создавать. Cкpипaч(96 знак., 28.05.2024 16:54)
- это правило хорошего тона. .h файл должен быть самодостаточным. Это нужно чтобы если кто-то решил подключить ваш файл к себе в проект к своему модулю ему не нужно было бы искать и подключать до этого .h файла другие .h файлы чтобы его модуль скомпилировался без ошибок. Поэтому все типы используемые в создаваемом .h файле должны быть описаны в подключенных к нему .h -файлах. А чтобы быть уверенным, что все подключил и не наподключал чего лишнего вот тут компиляция и abivan(196 знак., 28.05.2024 17:37)
  - Блин. То что мне кажется само собой разумеющимся, оказывается не более чем "правило хорошего тона" :) - Cкpипaч(28.05.2024 17:50)
    - ну вообще то это советы были не тебе, а Mty1. И было сказано, как это сделать, что бы проверить себя. Не только лишь все могут писать код без ошибок и отладки. - abivan(28.05.2024 18:25)
Современные компиляторы все понимают #pragma once - VladislavS.(28.05.2024 12:14)
- тут не проблема в повторном подключении, ее не будет в первом случае точно, а постановка гарда в конце позволит выявить логические ошибки при создании(написании) .h файлов, когда оба файла включают друг друга. Труда поставить гард в конце никакого, а польза может быть. Более красивыми словами про это писал fk0. - abivan(28.05.2024 12:36)

По-моему, правильно делаете. - Nikolay_Po(28.05.2024 12:02)

Вопрос понятен, следует избегать общих .h потому что так появляются общие зависимости и твой код становится единым комком из которого потом тяжело что-либо удалить/изменить или использовать в новом проекте. Еще, у STM HAL и библиотек генерируемых STM32CubeMX / STM32CubeIDe есть проблема с main.h / main.c - благодаря тому что по-умолчанию в него генерится весь код связанный с Hardware и самое разумное решение так и сделать его чисто "Hardware". Свой application-specific RxTx(91 знак., 28.05.2024 09:12)

Спасибо, так и сделал. - Mty1(29.05.2024 00:12)

Настоятельно рекомендую использовать .h исключительно как описание интерфейса модуля (которым является .с). И ничего не предназначенного для использования вне его в .н файл не вписывать. - Cкpипaч(27.05.2024 20:17)

+1. - SciFi(27.05.2024 20:20)
- +2. Но!!! Модуль сам по себе может быть не монолитным. Я бы даже сказал - почти всегда не монолитен. Есть у модуля реализация на "чистом" С, С++ и т.д. У этой реализации есть свой интерфейс к аппаратно-зависимой части, которая использует регистры периферии, расширения языка С и пр. Это как 2 разных модуля, связаных др. с другом. И между ними тоже должен быть интерфейс в виде .h-файла. Внутренний. Который не предоставляется пользователю. - il-2(28.05.2024 16:53)
  - Вообще ни слова не понял. Имеется в виду что проект есть дерево импорта модулей более низкого уровня модулями более высокого уровня? - да, так и есть. И это нормально. - Cкpипaч(28.05.2024 16:56)
    - Ну, в общем да, речь именно про это :-) Но я специально выделил этот случай, т.к. часто делают по принципу 1 модуль = 1 интерфейс. И в этом интерфейсе кладут все - и экспортируемое, и импортируемое. - il-2(28.05.2024 17:17)
Хорошая концепция, благодарю. Думаю может сделать еще общий файл MyProj.h куда включить все остальные хедеры модулей? - Mty1(27.05.2024 20:20)
- Плохая идея. Никаких "остальных" хедеров быть не должно. Должны быть пары "интерфейс - реализация". И если что-то из них разрастается, то это сигнал и нужно думать о том что вы неэффективно нарезали модули и возможно (почти наверняка!) нарезать их мельче. Cкpипaч(495 знак., 27.05.2024 20:49)
  - не всегда так. вот мой пример, когда это не так. abivan(640 знак., 28.05.2024 12:27, картинка, картинка)
    - А зачем это? - Cкpипaч(28.05.2024 16:52)
    - Какой ужас. - SciFi(28.05.2024 12:28)
  - Есть еще вариант перейти на классы или namespaces. ASDFS(37 знак., 27.05.2024 20:53)
    - И? Сколько неймспейсов ты будешь ложить (класть?) в один файл? Cкpипaч(155 знак., 27.05.2024 21:01)
      - Тут главное что не нужно раскидывать по разным файлам внешний интерфейс и детали реализации в виде сабжевых констант. - ASDFS(27.05.2024 21:04)
        
        Еще раз - выделение интерфейса в отдельный файл - великое благо есть. Cкpипaч(289 знак., 27.05.2024 21:12)
        
        А ещё, константа может быть задана не в коде, а во время инстанциации кода. Константный параметр, который неизвестен до момента применения кода. - VladislavS.(28.05.2024 08:47)
        
        Именно поэтому плюсы вредны. ТС в сишечке только начинает разбираться. И тут бабах его по голове плюсами, чтобы точно понял, что никогда не разберётся :-) - SciFi(28.05.2024 08:50)
        
        Лучше сразу нарабатывать нормальные шаблоны программирования, чтобы потом не было мучительно больно их ломать. А то ведь так и будет до пенсии талдычить "интерфейс в .h - код в .c". Зубов бояться, ... :) - VladislavS.(28.05.2024 08:56)
        
        Лемма: Все шаблоны, наработанные ДО обретения достаточного ОПЫТА можно применять только для...новых анекдотов. Cкpипaч(287 знак., 28.05.2024 16:42)
        
        Вспомнился анекдот про сантехников и гаечные ключи :-) - SciFi(28.05.2024 08:57)
        
        Во-первых, вы о разных языках говорите. В них подходы сильно разные. Во-вторых, даже в С есть случаи когда код лучше писать в заголовочных файлах. Хороший пример такого кода можно посмотреть в библиотеке CMSIS. - VladislavS.(28.05.2024 06:06)
        
        Это из рубрики "вредные советы". Писать код в заголовочных файлах иногда имеет смысл именно в библиотеках. А в своём прикладном коде смысла не имеет. - SciFi(28.05.2024 07:48)
        
        Я сам чётко делю свой код на объявления в заголовочном файле и определения в файле *.c. Nikolay_Po(351 знак., 28.05.2024 12:13)
        
        Уточняйте о каком языке вы говорите. Для плюсов очень даже имеет и полезно. И почему вы выделяете библиотечный код? Кто мне запрещает переиспользовать любой класс какой захочу? - VladislavS.(28.05.2024 08:37)
        
        Так увлеклись объектным программированием, что забыли о модульном... - Cкpипaч(28.05.2024 16:45)
        
        Класс это такая штука где в одном хидере описывается все, и потроха и внешний интерфейс. ASDFS(61 знак., 27.05.2024 21:18)
        
        А я разве не так сказал? Описывай класс в .hрр, а его методы в .срр. А для Си - в интерфейсе объяви методы и типы данных, а реализацию методов положи в .с - Cкpипaч(27.05.2024 21:22)
        
        Описывай класс в .hрр, а его методы в .срр. - Сейчас так не делают. Методы тоже в hpp пишут. В cpp попадают только всякие функции обработки прерываний, определения глобальных объектов и функция main. Остальной код прекрасно живёт в hpp. А в последних стандартах вообще в модулях, но это пока не пошло в массы. - VladislavS.(28.05.2024 05:53)
        
        А я и не говорю что сейчас делают правильно. Cкpипaч(229 знак., 28.05.2024 16:49)
        
        В этом есть качество оптимизации кода. - VladislavS.(28.05.2024 17:30)
        
        За преждевременную оптимизацию положено расстреливать из рогатки. А за избыточные межмодульные связи - из чего поболее. - Cкpипaч(28.05.2024 17:56)
        
        Где обнаружена преждевременная оптимизация? Наоборот, оптимизация отдана на откуп компилятору. Чем больше кода одновременно доступно компилятору, тем лучше результат он получит. Причём, с одним ключом размер минимальный получу, с другим скорость максимальную. Всё само без моего участия. - VladislavS.(28.05.2024 18:02)
        
        Запихнул ВСЕ в одну единицу трансляции и еще спрашивает 8) Во истину, чудны дела твои, господи. - Cкpипaч(28.05.2024 18:52)
        
        Почему запихнул? Я не делаю для этого никаких дополнительных усилий. Просто пишу код как обычно. Остальное забота компилятора. - VladislavS.(28.05.2024 19:22)
        
        справедливости ради надо признать что подобный подход довольно эффективен для тощщего железа ASDFS(68 знак., 28.05.2024 19:00)
        
        Угу. Позволит упихнуть в два раза по памяти и в три по скорости. Верю. Уже. - Cкpипaч(28.05.2024 19:06)
        
        У Яра есть галочка "Multi-file Compilation" а в ней подгалочка "Discard Unused Publics". Иногда результаты удивляют. - LightElf(28.05.2024 19:10)
        
        Это "галочка" к линкеру, а не к компилятору. - Cкpипaч(28.05.2024 20:14)
        
        Она в закладке настроек компилятора, а не линкера. - LightElf(28.05.2024 23:15)
        
        Не-не, у яра --mfc ключик компилятора. У GCC --flto тоже ключик компилятора. - SciFi(28.05.2024 20:18)
        
        Поверь, вдумчивое, заинтересованное обсуждение ТЗ с заказчиком может удивить куда сильнее. Cкpипaч(838 знак., 28.05.2024 19:24)
        
        Заказчик - это не моя зона ответственности. Как нетрудно заметить, это не сильная моя сторона :-) - LightElf(28.05.2024 23:13)
        
        Погромизды впадают в грех, забывая заветы пророка Д.Кнута... SciFi(1 знак., 28.05.2024 17:33, картинка)
        
        Отличная концепция, спасибо. Так и сделаю. - Mty1(27.05.2024 21:32)
- Зачем? По хорошему модуль подключает те и только те хедеры, которые он использует. Так явным образом записывается список зависимостей. Оттуда даже граф зависимостей между модулями можно нарисовать. - SciFi(27.05.2024 20:22)

Микроконтроллеры