Befehlszeilenoptionen für vorcompilierte Header von BCC32

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu BCC32.EXE: Der C++-32-Bit-Befehlszeilen-Compiler


Vorcompilierte Header-Dateien können die Compiliergeschwindigkeit deutlich erhöhen, indem sie ein Image der Symboltabelle in einer Datei auf der Festplatte speichern und dann später diese Datei von der Festplatte laden, anstatt alle Header-Dateien erneut zu analysieren. Das direkte Laden der Symboltabelle ist viel schneller als das Analysieren des Textes von Header-Dateien, besonders dann, wenn mehrere Quelltextdateien dieselbe Header-Datei einbeziehen.

Verwenden Sie für vorcompilierte Header-Dateien in der Befehlszeile die folgenden Optionen in BCC32-Befehlen.

Optionen für vorcompilierte Header:

Compiler-Option Beschreibung Details
-H

Erzeugen und verwenden

Wenn diese Option aktiviert ist, erzeugt und verwendet der Compiler vorcompilierte Header-Dateien. Der Standarddateiname für den erzeugten vorcompilierten Header lautet BC32DEF.CSM für den Befehlszeilen-Compiler.

Verwenden Sie den folgenden Befehl, um einen vorcompilierten Header anzugeben:

-H=myhdrfile.h

Verwenden Sie den folgenden Befehl, um den vorcompilierten Header für eine bestimmte Quelldatei zu aktivieren:

-H File2.cpp
-Hu

Verwenden, aber nicht erzeugen

Wenn diese Option aktiviert ist, verwendet der Compiler vorhandene vorcompilierte Header-Dateien; neue vorcompilierte Header-Dateien werden nicht erzeugt.

-H-

Nicht erzeugen oder verwenden

Wenn diese Option aktiviert ist, erzeugt und verwendet der Compiler keine vorcompilierten Header-Dateien. Vorgabe = Nicht erzeugen oder verwenden (-H-)

-Hc

Vorcompilierte Header zwischenspeichern

Wenn diese Option aktiviert ist, speichert der Compiler die erzeugten vorcompilierten Header im Cache. Dies ist besonders dann hilfreich, wenn mehr als eine Header-Datei vorcompiliert wird. Für diese Option muss auch die Option "Erzeugen und verwenden" (-H) für vorcompilierte Header aktiviert sein. Vorgabe = Aus.

-He

Externe Typdateien (vorcompilierte Header) erzeugen

Wenn diese Option aktiviert ist, erzeugt der Compiler eine oder mehrere Dateien, die Debug-Typinformationen für alle Symbole aus den vorcompilierten Headern enthalten. Die Dateinamen enden mit der Erweiterung .#xx, wobei xx für die erste erzeugte Datei 00 ist; für alle weiteren, erforderlichen Typinformationsdateien wird die Zahl jeweils um 1 erhöht. Durch diese Option wird die Größe der OBJ-Dateien deutlich reduziert, da die Debug-Typinformationen zentralisiert werden und sich nicht mehr in jeder OBJ-Datei wiederholen. Vorgabe = Ein.

-H=myhdrfile.h

Dateiname des vorcompilierten Headers

Mit dieser Option geben Sie den Namen der vorcompilierten Header-Datei an. Wenn diese Option gesetzt ist, erzeugt und verwendet der Compiler die angegebene vorcompilierte Header-Datei.

-Hh=<xxx>

oder

-H\"<xxx>\"

Vorcompilierung anhalten nach Header-Dateioption

Diese Option hält das Compilieren des vorcompilierten Headers nach der Verarbeitung der mit xxx angegebenen Datei an. Mit dieser Option reduzieren Sie den Platz auf dem Datenträger, der für vorcompilierte Header erforderlich ist.

Die Syntax von -Hh ist im Allgemeinen einfacher zu verwenden als die Syntax von -H. Beispiele:

-Hh=myhdrfile.h
-H\"myhdrfile.h\"
-Hh="C:\Program Files\myhdrfile.h"
-H\"C:\Program Files\myhdrfile.h\"
  • Für diese Option muss die angegebene Datei von einer Quelltextdatei einbezogen (include) werden, damit der Compiler eine vorcompilierte Header-Datei erzeugen kann.
  • In Quelltextdateien können Sie auch mit #pragma hdrstop angeben, wann die Erzeugung von vorcompilierten Headern beendet werden soll.
  • Sie können keinen Namen einer Header-Datei angeben, die von einer anderen Header-Datei einbezogen wird. Dies gilt beispielsweise für einen Header, der von WINDOWS.H eingebunden wird, denn das würde bewirken, dass die vorcompilierte Header-Datei bereits geschlossen wurde, bevor die Compilierung von WINDOWS.H abgeschlossen ist.
-Hi myhdrfile.h

Für vorcompilierte Header-Datei verwenden

Wenn Sie diese Option angeben, bezieht BCC32 den Inhalt der angegebenen Header-Datei und die angegebene Header-Datei zuerst ein.

Die Kombination von -Hh und -Hi entspricht dem Einfügen der folgenden Direktiven am Anfang jeder CPP-Datei:

 #include "myhdrfile.h"
 #pragma hdrstop


Siehe auch