Variáveis de ambiente CL
A ferramenta CL usa as seguintes variáveis de ambiente:
CL e _CL_, se definidas. A ferramenta CL acrescenta as opções e os argumentos definidos na variável de ambiente CL, aos argumentos de linha de comando e acrescenta as opções e argumentos definidos na _CL_, antes do processamento.
INCLUDE, que deve apontar para o subdiretório \include da sua instalação do Visual Studio.
LIBPATH, que especifica diretórios para pesquisar arquivos de metadados referenciados com #using. Para obter mais informações sobre a LIBPATH, confira #using.
Você pode definir a variável de ambiente CL ou _CL_ usando a seguinte sintaxe:
SET CL=[ [opção] ... [arquivo] ...] [/link link-opt ...]
SET _CL_=[ [option] ... [file] ...] [/link link-opt ...]
Para obter detalhes sobre os argumentos das variáveis de ambiente CL e _CL_, confira Sintaxe de linha de comando do compilador do MSVC.
Você pode usar essas variáveis de ambiente para definir os arquivos e as opções que você usa com mais frequência. Em seguida, você pode usar a linha de comando para fornecer mais arquivos e opções à CL para fins específicos. As variáveis de ambiente CL e _CL_ estão limitadas a 1.024 caracteres (o limite de entrada da linha de comando).
Você não pode usar a opção /D para definir um símbolo que use um sinal de igual (=). Em vez disso, use o sinal de número (#) para um sinal de igual. Dessa forma, você pode usar as variáveis de ambiente CL ou _CL_ para definir constantes de pré-processador com valores explícitos, por exemplo, /DDEBUG#1
para definir DEBUG=1
.
Para obter mais informações, confira Usar o conjunto de ferramentas do MSVC na linha de comando.
Exemplos
O comando a seguir é um exemplo de como definir a variável de ambiente CL:
SET CL=/Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ
Quando a variável de ambiente CL é definida, se você inserir CL INPUT.C
na linha de comando, o comando efetivamente se tornará:
CL /Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ INPUT.C
O exemplo a seguir faz com que um comando CL sem formatação compile os arquivos de origem FILE1.c e FILE2.c e vincule os arquivos de objeto FILE1.obj, FILE2.obj e FILE3.obj:
DEFINA CL=ARQUIVO1. C ARQUIVO2. C
SET _CL_=ARQUIVO3. OBJ
CL
Essas variáveis de ambiente fazem com que a chamada à CL tenha o mesmo efeito que a seguinte linha de comando:
CL FILE1.C FILE2.C FILE3.OBJ