Partage via

Variables d’environnement CL

  • Article

L'outil CL utilise les variables d'environnement suivantes :

  • CL et _CL_, s’ils sont définis. L’outil CL ajoute les options et les arguments définis dans la variable d’environnement CL aux arguments de ligne de commande et ajoute les options et arguments définis dans _CL_, avant le traitement.

  • INCLUDE, qui doit pointer vers le sous-répertoire \include de votre installation de Visual Studio.

  • LIBPATH, qui spécifie des répertoires pour rechercher des fichiers de métadonnées référencés avec #using. Pour plus d’informations sur LIBPATH, consultez #using.

Vous pouvez définir la variable d’environnement CL ou _CL_ à l’aide de la syntaxe suivante :

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

Pour plus d’informations sur les arguments des variables d’environnement CL et _CL_, consultez la syntaxe de ligne de commande du compilateur MSVC.

Vous pouvez utiliser ces variables d’environnement pour définir les fichiers et les options que vous utilisez le plus souvent. Utilisez ensuite la ligne de commande pour donner davantage de fichiers et d’options à CL à des fins spécifiques. Les variables d’environnement CL et _CL_ sont limitées à 1 024 caractères (limite d’entrée de ligne de commande).

Vous ne pouvez pas utiliser l’option /D pour définir un symbole qui utilise un signe égal (=). Au lieu de cela, vous pouvez utiliser le signe numérique (#) pour un signe égal. De cette façon, vous pouvez utiliser les variables d’environnement CL ou _CL_ pour définir des constantes de préprocesseur avec des valeurs explicites, par exemple /DDEBUG#1 pour définir DEBUG=1.

Pour plus d’informations, consultez l’ensemble d’outils MSVC à partir de la ligne de commande.

Exemples

La commande suivante est un exemple de définition de la variable d’environnement CL :

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

Lorsque la variable d’environnement CL est définie, si vous entrez CL INPUT.C à la ligne de commande, la commande effective devient :

CL /Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE. ENTRÉE OBJ. C

Dans l'exemple suivant, une commande CL simple compile les fichiers sources FILE1.c et FILE2.c, puis lie les fichiers objets FILE1.obj, FILE2.obj et FILE3.obj :

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

Ces variables d’environnement effectuent l’appel à CL ont le même effet que la ligne de commande suivante :

CL FILE1. C FILE2. C FILE3. OBJ

Voir aussi

Définition des options du compilateur
Options du compilateur MSVC