/I (Répertoires include supplémentaires)

  • Article

Ajoute un répertoire à la liste des répertoires recherchés pour inclure des fichiers.

Syntaxe

/Idirectory

Arguments

directory
Répertoire à ajouter à la liste des répertoires recherchés pour inclure des fichiers. L’espace entre /I et le répertoire est facultatif. Les répertoires qui incluent des espaces doivent être placés entre guillemets doubles. Un répertoire peut être un chemin absolu ou un chemin relatif.

Notes

Pour ajouter plusieurs répertoires, utilisez cette option plusieurs fois. Les répertoires sont recherchés uniquement jusqu’à ce que le fichier include spécifié soit trouvé.

Vous pouvez utiliser cette option sur la même ligne de commande que l’option (/X Ignorer les chemins include standard)).

Une #include directive peut être spécifiée sous forme de guillemets doubles (ou local-first), par exemple #include "local.h". Ou bien, il peut être spécifié sous forme d’angle (ou include-path-first), par exemple #include <iostream>.

Le compilateur recherche les répertoires dans l’ordre suivant :

  1. Si la directive est spécifiée à l’aide #include d’un formulaire de guillemets doubles, elle recherche d’abord les répertoires locaux. La recherche commence dans le même répertoire que le fichier qui contient la #include directive. S’il ne parvient pas à trouver le fichier, il recherche ensuite dans les répertoires des fichiers include actuellement ouverts, dans l’ordre inverse dans lequel ils ont été ouverts. La recherche commence dans le répertoire du fichier Include parent et continue vers le haut, dans les répertoires de tous les fichiers Include grands-parents.

  2. Si la #include directive est spécifiée sous forme de crochets angle ou si la recherche dans le répertoire local a échoué, elle recherche les répertoires spécifiés à l’aide de l’option /I , dans l’ordre dans lequel elles sont spécifiées sur la ligne de commande.

  3. Répertoires spécifiés dans la variable d’environnement INCLUDE .

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de>propriétés de configuration C/C++>Général.

  3. Modifiez la propriété Autres répertoires Include. Vous pouvez spécifier plusieurs répertoires à la fois dans cette propriété. Les répertoires doivent être séparés par un point-virgule (;).

Pour définir cette option du compilateur par programmation

Exemple

La commande suivante recherche les fichiers include demandés dans main.c l’ordre suivant : Tout d’abord, si spécifié à l’aide de guillemets doubles, les fichiers locaux sont recherchés. Ensuite, la recherche se poursuit dans le \include répertoire, puis dans le \my\include répertoire, puis dans les répertoires affectés à la variable d’environnement, dans l’ordre INCLUDE gauche à droite.

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

Voir aussi

Options du compilateur MSVC
Syntaxe de la ligne de commande du compilateur MSVC