Udostępnij za pośrednictwem

Zmienne środowiskowe CL

  • Artykuł

Narzędzie CL używa następujących zmiennych środowiskowych:

  • CL i _CL_, jeśli zostały zdefiniowane. Narzędzie CL poprzedza opcje i argumenty zdefiniowane w zmiennej środowiskowej CL do argumentów wiersza polecenia i dołącza opcje i argumenty zdefiniowane w _CL_, przed przetworzeniem.

  • INCLUDE, który musi wskazywać \include podkatalog instalacji programu Visual Studio.

  • LIBPATH, który określa katalogi do wyszukiwania plików metadanych, do których odwołuje się #using. Aby uzyskać więcej informacji na temat biblioteki LIBPATH, zobacz #using.

Zmienną środowiskową CL lub _CL_ można ustawić przy użyciu następującej składni:

SET CL=[ [opcja] ... [plik] ...] [/link link-opt ...]
SET _CL_=[ [opcja] ... [plik] ...] [/link link-opt ...]

Aby uzyskać szczegółowe informacje na temat argumentów zmiennych środowiskowych CL i _CL_, zobacz Składnia wiersza polecenia kompilatora MSVC.

Możesz użyć tych zmiennych środowiskowych, aby zdefiniować pliki i opcje, których najczęściej używasz. Następnie użyj wiersza polecenia, aby udostępnić więcej plików i opcji cl do określonych celów. Zmienne środowiskowe CL i _CL_ są ograniczone do 1024 znaków (limit danych wejściowych wiersza polecenia).

Nie można użyć /D opcji do zdefiniowania symbolu, który używa znaku równości (=). Zamiast tego możesz użyć znaku numeru (#) dla znaku równości. W ten sposób można użyć zmiennych środowiskowych CL lub _CL_, aby zdefiniować stałe preprocesora z jawnymi wartościami — na przykład /DDEBUG#1 w celu zdefiniowania DEBUG=1.

Aby uzyskać więcej informacji, zobacz Use the MSVC toolset from the command line (Używanie zestawu narzędzi MSVC z wiersza polecenia).

Przykłady

Następujące polecenie jest przykładem ustawienia zmiennej środowiskowej CL:

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

Po ustawieniu zmiennej środowiskowej CL, jeśli wprowadzisz CL INPUT.C polecenie w wierszu polecenia, skuteczne polecenie stanie się:

CL /Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE. DANE WEJŚCIOWE OBJ. C

Poniższy przykład powoduje skompilowanie plików źródłowych FILE1.c i FILE2.c, a następnie połączenie plików obiektów FILE1.obj, FILE2.obj i FILE3.obj:

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

Te zmienne środowiskowe sprawiają, że wywołanie cl ma taki sam efekt jak w następującym wierszu polecenia:

CL FILE1. C FILE2. C FILE3. OBJ

Zobacz też

Ustawianie opcji kompilatora
Opcje kompilatora MSVC