BCC32.EXE, le compilateur C++ 32 bits en ligne de commande

De RAD Studio
Aller à : navigation, rechercher

Remonter à Interfaces de ligne de commande des compilateurs C++


BCC32.EXE est l'interface en ligne de commande du BCC32, le compilateur C++ pour Windows 32 bits.

Syntaxe de la ligne de commande

bcc32 [<option>] <filename> [<filename>...]

Utilisez des espaces pour séparer le nom du compilateur, chaque option et les noms de fichier sur la ligne de commande. Placez devant chaque option un tiret (-) ou une barre oblique (/). Par exemple :

BCC32 -Ic:\code\hfiles

Vous pouvez aussi spécifier les options dans les fichiers de configuration (.CFG), décrits dans Utilisation des fichiers de configuration du compilateur (fichiers .CFG).

Vous pouvez utiliser BCC32 pour envoyer les fichiers .OBJ à ILINK32 ou les fichiers .ASM à TASM32 (si TASM32 est installé sur votre machine).

Affichage de l'aide de la ligne de commande pour obtenir des informations détaillées

Pour afficher l'aide de la ligne de commande de BCC32.exe dans la fenêtre cmd, incluez l'option de ligne de commande -h.

Par exemple, pour afficher la liste des options de la ligne de commande du compilateur les plus courantes, tapez :

BCC32 -h

Dans la liste affichée, * indique les options qui sont activées par défaut.

Affichage de l'aide pour des options spécifiques, des groupes tels que -Axxx et -Vxxx

Vous pouvez obtenir des informations plus spécifiques sur les options multilettres, telles que -Axxx (compatibilité du langage et conformité aux standards) et -Vxxx (compatibilité descendante).

Pour ce faire, utilisez l'option de ligne de commande -h avec la lettre initiale du groupe d'options (telle que -A, pour spécifier les options -Axxx. BCC32 affichera seulement les rubriques d'aide pour le jeu d'options spécifié (tel que -Axxx, -Vxxx, ou -Wxxx).

Par exemple, pour afficher une description des options -Axxx (compatibilité du langage et conformité aux standards), utilisez les options de ligne de commande -h et -A :

C:\>bcc32 -h -A

Paramètres par défaut

BCC32.EXE comporte des options spécifiques qui sont activées par défaut. Pour désactiver une option par défaut ou redéfinir les options d'un fichier de configuration, placez un signe moins (-) après l'option.

Les fichiers d'extension .CPP sont compilés comme des fichiers C++. Les fichiers d'extension .C, sans extension ou avec une extension différente de .CPP, .OBJ, .LIB ou .ASM sont compilés comme des fichiers C.

Le compilateur essaie de lier avec un fichier de définition de module de même nom que l'exécutable et l'extension .DEF.

Options générales de sortie du compilateur

Option Description Détails

-c

Compile en .OBJ, pas de liaison.

Compile et assemble les fichiers .C, .CPP et .ASM nommés, mais n'exécute pas un lien sur les fichiers .OBJ résultants.

-e <filename>

Spécifie le nom du fichier exécutable

Lie le fichier en utilisant <filename> en tant que nom du fichier exécutable. Si vous ne spécifiez pas un nom d'exécutable avec cette option, le lieur crée un fichier exécutable basé sur le nom du premier fichier source ou fichier objet mentionné dans la commande.

-l <x>

Passe l'option au lieur.

Utilisez cette option de ligne de commande pour passer les options <x> au lieur dans une commande de compilation. Utilisez l'option de ligne de commande -l-x pour désactiver une option spécifique du lieur.

-M

Crée un fichier MAP.

Utilisez cette option du compilateur pour demander au lieur de créer un fichier map. Voir Fichier Map des segments détaillés.

-o <filename>

Compile en <filename>.OBJ.

Compile le fichier source spécifié en <filename>.OBJ.

-P

Compilation C++

Provoque la compilation C++ de tous les fichiers source, quelle que soit leur extension. Utilisez l'option -P- pour compiler tous les fichiers .CPP en tant que fichiers source C++ et tous les autres fichiers en tant que fichiers source C. L'option de ligne de commande -P provoque la compilation de tous les fichiers source en tant que fichiers C++. Cette option est fournie car certains programmeurs utilisent une autre extension par défaut pour le code C++.

-tM

Génère une cible multithread.

Crée un .EXE ou .DLL multithread. Cette option n'est pas nécessaire si vous incluez un fichier de définition de module (fichier .DEF) dans vos commandes de compilation et de liaison, spécifiant le type d'application 32 bits que vous voulez construire.

-tR

La cible utilise la RTL dynamique.

Crée une application qui utilise la RTL dynamique.

-tV

La cible utilise le framework VCL GUI. 

     -tD

La cible est une bibliothèque partagée. 

     -tP

Génère un package.

Remarque: N'utilisez pas l'option -t depuis l'EDI.

Règles de priorité des options du compilateur

Les compilateurs en ligne de commande évaluent les options de la gauche vers la droite, et suivent ces règles :

  • Si vous dupliquez une option (à l'exception des options -D, -I, -L ou -U), la dernière option tapée redéfinit toute option antérieure.
  • Les options tapées sur la ligne de commande redéfinissent les options des fichiers de réponse et de configuration à l'exception des options -D, -I, -L et -U, qui sont cumulatives.

Spécification des répertoires dans les options de la ligne de commande

Le compilateur C++ peut rechercher les fichiers de bibliothèque et d'inclusion dans plusieurs répertoires. La syntaxe de l'option des répertoires de bibliothèque (-L) et des répertoires d'inclusion (-I) (comme l'option #define (-D)) permet plusieurs listages d'une option donnée. Voici la syntaxe de ces options :

-L <dirname> [<dirname>;...]
-I <dirname> [<dirname>;...]

Le paramètre <dirname> utilisé avec -L et -I peut correspondre à tout répertoire ou chemin de répertoire. Vous pouvez entrer ces répertoires sur la ligne de commande de l'une des façons suivantes :

  • Vous pouvez empiler plusieurs entrées avec une seule option -L ou -I en les séparant par un point virgule :
BCC32.EXE -L dirname1;dirname2;dirname3 -I include1;include2;include3 myfile.c
  • Vous pouvez placer plusieurs occurrences de chaque option sur la ligne de commande, comme suit :
BCC32.EXE -L dirname1 -L dirname2 -L dirname3 -I include1 -I include2 -I include3 myfile.c
  • Vous pouvez mélanger les styles :
BCC32.EXE -L dirname1;dirname2 -Ldirname3 -I include1;include2 -I include3 myfile.c

Si vous listez plusieurs options -L ou -I sur la ligne de commande, le résultat est cumulatif. Le compilateur recherche tous les répertoires listés, de la gauche vers la droite.

Utilisation des fichiers de configuration du compilateur (fichiers .CFG)

Si vous utilisez de façon répétitive un certain nombre d'options, vous pouvez les lister dans un fichier de configuration au lieu de les taper continuellement sur la ligne de commande. Un fichier de configuration est un fichier texte ASCII standard qui contient une ou plusieurs options de ligne de commande. Chaque option doit être séparée par un espace ou une nouvelle ligne.

A chaque émission d'une commande de compilation, BCC32.EXE recherche le fichier de configuration BCC32.CFG. Le compilateur recherche d'abord le fichier .CFG dans le répertoire d'où provient la commande de compilation, puis dans le répertoire où se trouve le compilateur.

Vous pouvez créer et utiliser plusieurs fichiers de configuration en supplément du fichier .CFG par défaut.

Pour utiliser un fichier de configuration, utilisez la syntaxe suivante où vous placerez les options du compilateur :

+[chemin]nomfichier

Par exemple, vous pouvez utiliser la ligne de commande suivante pour le fichier de configuration MYCONFIG.CFG :

BCC32 +C:\MYPROJ\MYCONFIG.CFG moncode.cpp

Les options tapées sur la ligne de commande remplacent les paramètres stockés dans les fichiers de configuration, à l'exception des options cumulatives -D, -I, -L et -U.

Utilisation des fichiers de réponse

Les fichiers de réponse vous permettent de lister les options du compilateur et les noms de fichier dans un seul fichier (à l'inverse des fichiers de configuration qui n'acceptent que les options du compilateur). Un fichier de réponse est un fichier texte au format ASCII standard contenant une ou plusieurs options de ligne de commande, les noms de fichier, ou les deux, avec chaque entrée du fichier séparée par un espace ou une nouvelle ligne. En plus de simplifier les commandes du compilateur, les fichiers de réponse permettent d'avoir une ligne de commande plus longue que ce qui est autorisé par la plupart des systèmes d'exploitation.

Voici la syntaxe d'utilisation d'un fichier de réponse unique :

BCC32 @[chemin]respfile.txt

Voici la syntaxe d'utilisation de fichiers de réponse multiples :

BCC32 @[chemin]respfile.txt @[chemin]otheresp.txt

Les fichiers de réponse ont typiquement une extension .RSP.

Les options tapées sur la ligne de commande redéfinissent les options ou noms de fichier d'un fichier de réponse, à l'exception des options -D, -I, -L et -U qui sont cumulatives.

Rubriques

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/RADStudio/Athens/f/index.php?title=BCC32.EXE,_le_compilateur_C%2B%2B_32_bits_en_ligne_de_commande&oldid=215968 »