2.1 Синтаксис включения

Заголовочные файлы пользователя и системы включаются с помощью директивы препроцессора ‘#include’. Она имеет два варианта:

#include <file>

Этот вариант используется для заголовочных файлов системы. Он ищет файл с именем file в стандартном списке системных каталогов. Вы можете добавить каталоги в этот список с помощью опции -I (см. Вызов).

#include "file"

Этот вариант используется для заголовочных файлов вашей программы. Он ищет файл с именем file сначала в каталоге, содержащем текущий файл, затем в каталогах с кавычками, а затем в тех же каталогах, что и для <file>. Вы можете добавить каталоги в список каталогов с кавычками с помощью опции -iquote.

Аргумент ‘#include’, независимо от того, ограничен ли он кавычками или угловыми скобками, ведет себя как строковая константа, в которой не распознаются комментарии, а имена макросов не расширяются. Таким образом, #include <x/*y> указывает на включение заголовочного файла системы с именем x/*y.

Однако, если обратные слэши встречаются в file, они рассматриваются как обычные символы текста, а не как управляющие символы. Ни одна из последовательностей управляющих символов, подходящих для строковых констант в C, не обрабатывается. Таким образом, #include "x\n\\y" указывает на имя файла, содержащее три обратных слэша. (Некоторые системы интерпретируют ‘\’ как разделитель пути. Все они также интерпретируют ‘/’ одинаково. Наиболее переносимым является использование только ‘/’.)

Ошибка возникает, если в строке после имени файла присутствует что-либо (кроме комментариев).