Variables de entorno de CL

  • Artículo

La herramienta CL usa las siguientes variables de entorno:

  • CL y _CL_, si se definen. La herramienta CL antepone las opciones y los argumentos definidos en la variable de entorno de CL a los argumentos de la línea de comandos y anexa las opciones y los argumentos definidos en _CL_ antes del procesamiento.

  • INCLUDE, que debe señalar al subdirectorio \include de la instalación de Visual Studio.

  • LIBPATH, que especifica los directorios en los que se van a buscar archivos de metadatos a los que se hace referencia con #using. Para obtener más información sobre LIBPATH, vea #using.

Puede establecer la variable de entorno CL o _CL_ mediante la sintaxis siguiente:

SET CL=[ [option] ... [archivo] ...] [/link link-opt ...]
SET _CL_=[ [option] ... [file] ...] [/link link-opt ...]

Para obtener más información sobre los argumentos de las variables de entorno de CL y _CL_, consulte Sintaxis de línea de comandos del compilador MSVC.

Puede usar estas variables de entorno para definir los archivos y las opciones que emplea con más frecuencia. A continuación, use la línea de comandos para dar más archivos y opciones a CL para fines específicos. Las variables de entorno CL y _CL_ están limitadas a 1024 caracteres (el límite de entrada de la línea de comandos).

No puede usar la opción /D para definir un símbolo que use un signo igual (=). Puede sustituir el signo de número (#) por un signo igual. De este modo, puede usar las variables de entorno de CL o _CL_ para definir las constantes de preprocesador con valores explícitos, como, por ejemplo, /DDEBUG#1 para definir DEBUG=1.

Para obtener más información, vea Usar el conjunto de herramientas de MSVC desde la línea de comandos.

Ejemplos

El siguiente comando es un ejemplo de configuración de la variable de entorno CL:

SET CL=/Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ

Cuando se establece la variable de entorno de CL, si escribe CL INPUT.C en la línea de comandos, este es el comando eficaz:

CL /Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ INPUT.C

En el ejemplo siguiente, un comando de CL sin formato compila los archivos de código fuente FILE1.c y FILE2.c y, a continuación, vincula los archivos objeto FILE1.obj, FILE2.obj y FILE3.obj:

SET CL=FILE1. C FILE2. C
SET _CL_=FILE3. OBJ
CL

Estas variables de entorno hacen que la llamada a CL tenga el mismo efecto que la siguiente línea de comandos:

CL FILE1.C FILE2.C FILE3.OBJ

Consulte también

Establecer las opciones del compilador
Opciones del compilador de MSVC