2.2 Операция включения

Директива ‘#include’ работает, направляя препроцессор C на сканирование указанного файла в качестве входных данных перед продолжением обработки остальной части текущего файла. Выходные данные препроцессора содержат уже сгенерированные данные, за которыми следуют данные, полученные из включённого файла, а затем данные, полученные из текста после директивы ‘#include’. Например, если у вас есть заголовочный файл header.h следующего вида,

char *test (void);

и главная программа под названием program.c, использующая заголовочный файл, выглядит так,

int x;
#include "header.h"

int
main (void)
{
  puts (test ());
}

компилятор увидит тот же поток токенов, что и если бы program.c считывал

int x;
char *test (void);

int
main (void)
{
  puts (test ());
}

Включаемые файлы не ограничиваются объявлениями и определениями макросов; это лишь типичные применения. Любой фрагмент программы C может быть включён из другого файла. Файл включения может даже содержать начало оператора, завершающегося в включающем файле, или конец оператора, начатого в включающем файле. Однако, включённый файл должен состоять из полных токенов. Комментарии и строковые литералы, не закрытые до конца файла включения, являются недопустимыми. Для восстановления работоспособности они считаются завершёнными в конце файла.

Чтобы избежать путаницы, лучше, если заголовочные файлы содержат только полные синтаксические единицы — объявления или определения функций, объявления типов и т.д.

Строка, следующая за директивой ‘#include’, всегда обрабатывается препроцессором C как отдельная строка, даже если включённый файл не содержит конечного символа новой строки.

Далее: Путь поиска, Предыдущее: Синтаксис включения, Наверх: Заголовочные файлы [Оглавление][Индекс]