/I (diretórios de inclusão adicionais)

  • Artigo

Adiciona um diretório à lista de diretórios pesquisados por arquivos de inclusão.

Sintaxe

/Idiretório

Argumentos

diretório
O diretório a ser adicionado à lista de diretórios pesquisados por arquivos de inclusão. O espaço entre /I e o directory é opcional. Diretórios que incluem espaços devem ser colocados entre aspas duplas. Um diretório pode ser um caminho absoluto ou um caminho relativo.

Comentários

Para adicionar mais de um diretório, use essa opção mais de uma vez. Os diretórios são pesquisados apenas até que o arquivo de inclusão especificado seja encontrado.

É possível usar essa opção na mesma linha de comando que a opção (/X (Ignorar caminhos de inclusão padrões)).

Uma diretiva #include pode ser especificada no formulário de aspas duplas (ou primeiro localmente), por exemplo, #include "local.h". Ou pode ser especificada em colchete angular (ou primeiro caminho de inclusão), por exemplo, #include <iostream>.

O compilador pesquisa diretórios na seguinte ordem:

  1. Se a diretiva #include for especificada usando o formulário de aspas duplas, ela primeiro pesquisará diretórios locais. A pesquisa começa no mesmo diretório que o arquivo contendo a diretiva #include. Se não encontrar o arquivo, será pesquisado nos diretórios dos arquivos incluídos atualmente abertos, na ordem inversa em que foram abertos. A pesquisa começará no diretório do arquivo de inclusão pai e continuará para cima até os diretórios de qualquer arquivo de inclusão avô.

  2. Se a diretiva #include for especificada na forma de colchetes angulares, ou se a pesquisa de diretório local falhar, ela pesquisará os diretórios especificados usando a opção /I, na ordem em que são especificados na linha de comando.

  3. Diretórios especificados na variável de ambiente INCLUDE.

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  2. Selecione a página de propriedades Propriedades da Configuração>C/C++>Geral.

  3. Modifique a propriedade Diretórios de inclusão adicionais. Você pode especificar mais de um diretório por vez nessa propriedade. Os diretórios devem ser separados por ponto e vírgula (;).

Para definir essa opção do compilador via programação

Exemplo

O comando a seguir procura os arquivos de inclusão solicitados por main.c na seguinte ordem: primeiro, se especificado usando aspas duplas, serão pesquisados os arquivos locais. Em seguida, a pesquisa continuará no diretório \include, depois no diretório \my\include e, por fim, nos diretórios atribuídos à variável de ambiente INCLUDE, na ordem da esquerda para a direita.

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

Confira também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC