CL-Umgebungsvariablen

  • Artikel

Das CL-Tool verwendet die folgenden Umgebungsvariablen:

  • CL und _CL_, falls definiert. Das CL-Tool stellt die optionen und Argumente, die in der CL-Umgebungsvariable definiert sind, den Befehlszeilenargumenten voran und fügt die in _CL_definierten Optionen und Argumente vor der Verarbeitung an.

  • INCLUDE, der auf das Unterverzeichnis \include Ihrer Visual Studio-Installation verweisen muss.

  • LIBPATH, das Verzeichnisse angibt, in denen nach Metadatendateien gesucht werden soll, auf die mit #using verwiesen wird. Weitere Informationen zu LIBPATH finden Sie unter #using.

Sie können die CL- oder _CL_-Umgebungsvariable mit der folgenden Syntax festlegen:

SET CL=[ [Option] ... [Datei] ...] [/link link-opt ...]
SET _CL_=[ [Option] ... [Datei] ...] [/link link-opt ...]

Ausführliche Informationen zu den Argumenten für die CL- und _CL_-Umgebungsvariablen finden Sie unter MSVC Compiler-Befehlszeilensyntax.

Sie können diese Umgebungsvariablen verwenden, um die Dateien und Optionen zu definieren, die Sie am häufigsten verwenden. Verwenden Sie dann die Befehlszeile, um weitere Dateien und Optionen für bestimmte Zwecke cl zu geben. Die CL- und _CL_-Umgebungsvariablen sind auf 1024 Zeichen beschränkt (die Befehlszeileneingabegrenze).

Sie können die Option /D nicht verwenden, um ein Symbol zu definieren, das ein Gleichheitszeichen (=) verwendet. Stattdessen können Sie das Nummernzeichen (#) für ein Gleichheitszeichen verwenden. Auf diese Weise können Sie die CL- oder _CL_-Umgebungsvariablen verwenden, um Präprozessorkonstanten mit expliziten Werten zu definieren, /DDEBUG#1 z. B. zum Definieren DEBUG=1.

Weitere Informationen finden Sie unter Verwenden des MSVC-Toolsets über die Befehlszeile.

Beispiele

Der folgende Befehl ist ein Beispiel für das Festlegen der CL-Umgebungsvariable:

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

Wenn die CL-Umgebungsvariable festgelegt ist, wenn Sie an der Befehlszeile eingeben CL INPUT.C , wird der effektive Befehl wie folgt:

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

Im folgenden Beispiel wird verursacht, dass ein unformatierter CL-Befehl die Quelldateien „FILE1.c“ und „FILE2.c“ kompiliert. Anschließend werden die Objektdateien „FILE1.obj“, „FILE2.obj“ und „FILE3.obj“ verknüpft.

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

Diese Umgebungsvariablen führen den Aufruf von CL genauso aus wie die folgende Befehlszeile:

CL FILE1. C FILE2. C FILE3. OBJ

Siehe auch

Festlegen von Compileroptionen
MSVC-Compileroptionen