/I (Дополнительные каталоги включения)

  • Статья

Добавляет каталог в список каталогов, на которых выполняется поиск файлов.

Синтаксис

/Idirectory

Аргументы

directory
Каталог, добавляемый в список каталогов, на которых выполняется поиск файлов. Пространство между /I каталогом является необязательным. Каталоги, содержащие пробелы, должны быть заключены в двойные кавычки. Каталог может быть абсолютным путем или относительным путем.

Замечания

Чтобы добавить несколько каталогов, используйте этот параметр несколько раз. Каталоги выполняются поиск только до тех пор, пока указанный файл include не найден.

Этот параметр можно использовать в той же командной строке, что и параметр (игнорировать/X стандартные пути включения)).

#include Директиву можно указать в формате double-quote (или local-first), например#include "local.h". Кроме того, его можно указать в форме угловой скобки (или include-path-first), например #include <iostream>.

Каталоги компилятора ищут в следующем порядке:

  1. #include Если директива указана с помощью формы двойной кавычки, сначала выполняется поиск локальных каталогов. Поиск начинается в том же каталоге, что и файл, содержащий директиву #include . Если файл не удается найти, он выполняет поиск рядом с каталогами открытых в настоящее время файлов, в обратном порядке, в котором они были открыты. Поиск начинается в каталоге родительского включаемого файла, а затем выполняется в каталогах всех включаемых файлов-прародителей.

  2. #include Если директива указана в форме угловой скобки или если поиск локального каталога завершился сбоем, он выполняет поиск каталогов, указанных с помощью /I параметра, в порядке, указанном в командной строке.

  3. Каталоги, указанные в переменной INCLUDE среды.

Установка данного параметра компилятора в среде разработки Visual Studio

  1. Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.

  2. Перейдите на страницу свойств Свойства конфигурации>C/C++>Общие.

  3. Измените свойство "Дополнительные каталоги включения". В этом свойстве можно указать несколько каталогов. Каталоги должны быть разделены точкой с запятой (;).

Установка данного параметра компилятора программным способом

Пример

Следующая команда ищет файлы включения, запрошенные main.c в следующем порядке: сначала, если указано с помощью двойных кавычки, локальные файлы выполняются поиск. Затем поиск продолжается в \include каталоге, затем в \my\include каталоге и, наконец, в каталогах, назначенных INCLUDE переменной среды, слева направо.

CL /I \include /I\my\include main.c

См. также

Параметры компилятора MSVC
Синтаксис командной строки компилятора MSVC