Additional include paths (-I)

Settings

Specify the absolute or relative path to the folders that contains your header files. To add a folder, do one of the following:

If you want to include the subfolders of the specified folder recursively, select the checkbox in the Subfolders column.

Below the Additional include paths option, you see a dropdown with the option Append to project include paths chosen. This indicates that the additional include paths are appended to the project-wide include paths by default. Project-wide include paths are the include paths specified for the option Include paths (Polyspace Test). You can also choose one of these options from the dropdown :

During static analysis or project build, the include paths are used for header file lookup in the order in which you add them. As a result, if a header file with a specific name exists in multiple locations, the file in the location added earlier gets used during project build or static analysis. In particular, if a header file exists both in a build-specific include path and a project-wide include path, and build-specific paths are appended to project-wide paths, the header file in the project-wide path gets used.

Tips

You can use project variables or system environment variables as shorthands in the include folder paths. If you share the project with another user who has the include folders in a different root location, utilizing environment variables can help ensure that the project stays in sync with include folder paths. For more information, see:

Command-Line Information

To use this option at the command line, you can either use the option directly or append the option in an options file.