next up previous
Next: Заголовочные файлы Up: style Previous: style

Предлагаемая последовательность частей файлов с исходным кодом

  1. Пролог.
    Обязательно. Опционально.

  2. Подключение заголовочных файлов.
    Если причина подключения не очевидна, она должна быть пояснена. В начале подключаются системные заголовочные файлы <sys/*.h>, после них идет пустая строка. Затем подключаются сетевые заголовочные файлы. Снова пустая строка. Потом должны подключаться заголовочные файлы стандартных библиотек. Последними подключаются пользовательские заголовочные файлы.
    #include <sys/mman.h>
    #include <sys/limits.h>
    
    #include <netinet/in.h>
    
    #include <stdio.h>
    #include <string.h>
    #include <unistd.h>
    
    #include "macro.h"
    #include "prototypes.h"
    

  3. Объявления, которые относятся ко всему файлу.
    Переменные, выполняющие сходные функции должны быть собраны в группы.

  4. Функции.
    Порядок функций должен быть продуман. Сходные функции располагаются вместе. Предпочтителен порядок положения функций в ширину (на одном уровне абстракции), а не в глубину (функции объявляются как можно ближе к их непосредственным вызовам).



Aleks Sherikov 2006-06-01