Как правильно разделить Си проект на файлы?

Question

[Rudtoha]

Всем привет! Вопрос крайне дилетантский: есть ли какие-то рекомендации/требования/правила по созданию архитектуры проекта? Подключать .h файлы нужно в .c или .h? Какое количество extern переменных уже считать "плохим"? и тд
Если более локально: у меня есть два .с и два .h файла. Каждый из них использует перекрестные переменные. Хочу все оформить так, чтобы было читабельно и логично.

Answer 1

[Василий Мельников]

Ну как минимум использование перекрестных переменных уже нелогично. Лучше функциями это обернуть. Как бы инкапсулировать в модуль.
Правильный способ это на бумаге нарисовать модули/объекты системы и обозначить как они взаимодействуют между собой и внешним миром. И уже исходя из этого разбивать. В идеале чем больше модуль похож на черный ящик тем лучше с точки зрения системности.
Как лакмусовая бумажка может использоваться то, что из одного модуля вдруг надо копаться в кишках другого, или знать о том как там что-то реализовано.
Как пример именно для Си - стандартная библиотека. Открываешь файл получаешь указатель на структуру FILE но тебе, абсолютно не важно какие там поля, создается она по malloc или заранее созданный объект из некоего массива таких объектов. Это уже скрыто реализацией. Есть функции которые работают с этим указателем и всё.
Как плохой пример "не очень черного ящика" можно рассмотреть strtok строка которая передается на вход будет модифицироваться и портится, что может быть не очевидным из семантики. Но сделано в угоду скорости и использования памяти.

Comments

[Rudtoha]

а что насчет подключаемых хэдеров?

[Василий Мельников]

Хедеры можно включать куда угодно. Главное помнить что include просто "вставляет" всё содержимое файла в это место.
Поэтому в них надо выносить только то что требуется для общения модуля с внешним миром.
И если то что в них описано требуется в другом хедере, то можно в него включить первый.
Например там описан нужный тип который используется в прототипе функции.
Условно если в хедере описана функции foo(FILE*) то надо в этот хедер включить stdio.h

Answer 2

[FD4A]

Хорошая архитектура только косвенно зависит от языка программирования. Я бы рекомендовал почитать Чистую архитектуру Роберта Мартина, читается легко и всё по делу.