Variáveis de ambiente CL

  • Artigo

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=FILE1. ARQUIVO C2. C
DEFINA _CL_=FILE3. 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

Confira também

Definindo opções do compilador
Opções do compilador MSVC