I

Specifies an additional directory for the include path.

IDE Equivalent

Windows:
General > Additional Include Directories
(/include)
Preprocessor > Additional Include Directories
(/include)
Linux: None
Mac OS X: Preprocessor > Additional Include Directories (/include)

Architectures

IA-32 architecture, Intel® 64 architecture, IA-64 architecture

Syntax

Linux and Mac OS X: -Idir
Windows:  /Idir

Arguments

dir Is the directory to add to the include path.

Default

OFF The default include path is used.

Description

This option specifies an additional directory for the include path, which is searched for module files referenced in USE statements and include files referenced in INCLUDE statements. To specify multiple directories on the command line, repeat the option for each directory you want to add.

For all USE statements and for those INCLUDE statements whose file name does not begin with a device or directory name, the directories are searched in this order:

  1. The directory containing the first source file.
    Note that if assume nosource_include is specified, this directory will not be searched.

  2. The current working directory where the compilation is taking place (if different from the above directory).

  3. Any directory or directories specified using the I option. If multiple directories are specified, they are searched in the order specified on the command line, from left to right.

  4. On Linux and Mac OS X systems, any directories indicated using environment variable FPATH. On Windows systems, any directories indicated using environment variable INCLUDE.

This option affects fpp preprocessor behavior and the USE statement.

Alternate Options

Linux and Mac OS X: None
Windows: /include

See Also

X compiler option

assume compiler option