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

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

#include <file>

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

#include "file"

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

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

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

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