/I (Directorios de inclusión adicionales)

  • Artículo

Agrega un directorio a la lista de directorios en que se buscan archivos de inclusión.

Sintaxis

/Idirectorio

Argumentos

directorio
El directorio que se agrega a la lista de directorios en que se buscan archivos de inclusión. El espacio entre /I y el directorio es opcional. Los directorios que incluyen espacios deben incluirse entre comillas dobles. Un directorio puede ser una ruta de acceso absoluta o una ruta de acceso relativa.

Comentarios

Para agregar más de un directorio, use esta opción más de una vez. Los directorios solo se buscan hasta que se encuentre el archivo de inclusión especificado.

Puede usar esta opción en la misma línea de comandos que la opción (/X (Omitir rutas de acceso de inclusión estándar)).

Se puede especificar una #include directiva en formato de comillas dobles (o local-first), por ejemplo, #include "local.h". O bien, se puede especificar en forma de corchete angular (o include-path-first), por ejemplo, #include <iostream>.

El compilador busca directorios en el orden siguiente:

  1. Si la directiva #include se especifica mediante el formato de comillas dobles, primero busca en directorios locales. La búsqueda comienza en el mismo directorio que el archivo que contiene la directiva #include. Si no encuentra el archivo, busca a continuación en los directorios de los archivos de inclusión abiertos actualmente, en el orden inverso en el que se abrieron. La búsqueda comienza en el directorio del archivo de inclusión principal y continúa hacia arriba por los directorios de cualquier archivo de inclusión primario principal.

  2. Si la directiva #include se especifica entre corchetes o si se ha producido un error en la búsqueda del directorio local, busca directorios especificados mediante la opción /I, en el orden en que se especifican en la línea de comandos.

  3. Directorios especificados por la variable de entorno INCLUDE.

Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione la página de propiedades Propiedades de configuración>C/C++>General.

  3. Modifique la propiedad Directorios de inclusión adicionales. Puede especificar más de un directorio a la vez en esta propiedad. Los parámetros deben estar separados por un punto y coma (;).

Para establecer esta opción del compilador mediante programación

Ejemplo

El siguiente comando busca los archivos de inclusión solicitados por main.c en el orden siguiente: En primer lugar, si se especifica mediante comillas dobles, se busca en los archivos locales. A continuación, la búsqueda continúa en el directorio \include, en el directorio \my\include y, por último, en los directorios asignados a la variable de entorno INCLUDE, en orden de izquierda a derecha.

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

Consulte también

Opciones del compilador de MSVC
Sintaxis de la línea de comandos del compilador MSVC