/I
(Répertoires include supplémentaires)
Ajoute un répertoire à la liste des répertoires recherchés pour inclure des fichiers.
Syntaxe
/I
répertoire
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 :
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.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.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
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.
Sélectionnez la page de propriétés Propriétés de configuration>C/C++>Général.
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
- Consultez AdditionalIncludeDirectories.
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