Verwendung von vorcompilierten Header-Dateien
Nach oben zu Befehlszeilenhilfsprogramme - Index
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.
Um vorcompilierte Header-Dateien zu verwenden, geben Sie die verschiedenen ‑H-Optionen in Ihrem BCC32-Befehl an.
Linker-Optionen:
| Compiler-Option | Beschreibung | Einzelheiten |
|---|---|---|
-H |
Erzeugen und verwenden |
Wenn diese Option aktiviert ist, erzeugt und verwendet der Compiler vorcompilierte Header-Dateien. Der Standarddateiname für den Befehlszeilen-Compiler lautet BC32DEF.CSM. |
-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 vorcompilierte 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=<Dateiname> |
Dateiname des vorcompilierten Header |
Mit dieser Option geben Sie den Namen Ihrer 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 Header 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=myhdr.h -H\"myhdr.h\" -Hh="C:\Programme\myhdr.h" -H\"C:\Programme\myhdr.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 Ihrer 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. |