/I (Additional include directories)
Adds a directory to the list of directories searched for include files.
The directory to add to the list of directories searched for include files. The space between
/I and directory is optional. Directories that include spaces must be enclosed in double quotes. A directory may be an absolute path or a relative path.
To add more than one directory, use this option more than once. Directories are searched only until the specified include file is found.
You can use this option on the same command line as the (
/X (Ignore standard include paths)) option.
#include directive can be specified in double-quote (or local-first) form, for example,
#include "local.h". Or, it can be specified in angle-bracket (or include-path-first) form, for example,
The compiler searches directories in the following order:
#includedirective is specified using double-quote form, it first searches local directories. The search begins in the same directory as the file that contains the
#includedirective. If it fails to find the file, it searches next in the directories of the currently opened include files, in the reverse order in which they were opened. The search begins in the directory of the parent include file and continues upward through the directories of any grandparent include files.
#includedirective is specified in angle-bracket form, or if the local directory search has failed, it searches directories specified by using the
/Ioption, in the order they're specified on the command line.
Directories specified in the
To set this compiler option in the Visual Studio development environment
Open the project's Property Pages dialog box. For details, see Set C++ compiler and build properties in Visual Studio.
Select the Configuration Properties > C/C++ > General property page.
Modify the Additional Include Directories property. You can specify more than one directory at a time in this property. Directories must be separated by a semicolon (
To set this compiler option programmatically
The following command looks for the include files requested by
main.c in the following order: First, if specified by using double-quotes, local files are searched. Next, search continues in the
\include directory, then in the
\my\include directory, and finally in the directories assigned to the
INCLUDE environment variable, in left to right order.
CL /I \include /I\my\include main.c