Flow-Direktiven und Variablen-Direktiven
Flow-Direktiven sind Steueranweisungen, die bestimmen, wie das Produkt Konfigurationsdateien verarbeitet. Flow-Direktiven beginnen immer mit %. Folgende Flow-Direktiven stehen zur Verfügung:
| Flow-Direktive | Syntax | Bedeutung |
|---|---|---|
| %include | %include<filespec> | Schließt eine oder mehrere Konfigurationsdateien mit ein, bevor mit der nächsten Zeile in dieser Konfigurationsdatei fortgefahren wird. <filespec> kann eine einzelne Datei angeben, oder auch Platzhalterzeichen enthalten, um viele Dateien mit einzuschließen. <filespec> kann eine Konfigurationsvariable enthalten. Beispiel:
%include $(_USTN_WORKSPACECFG) |
| %include<filespec> level <levelspec> | Die %include Direktive kann eine Konfigurationsvariablen-Ebene enthalten, auf der die Zuweisungen in der enthaltenen Datei angewendet werden (bis eine andere Ebenen-Direktive angetroffen wird). Beispiel:
%include $(_USTN_ROLECFG) level Role |
|
| %if | %if <expression> | Wenn <expression> als "wahr" ausgewertet wird, fahren Sie mit der nächsten Zeile fort, ansonsten springen Sie weiter zur übereinstimmenden %else, %elif, oder %endif Anweisung. Siehe Operatoren für die Syntax von <expression>. Beispiel:
%if $(PHASE)=="Final" |
| %ifdef | %ifdef<cfgvar> | Wenn <cfgvar> definiert ist, fahren Sie mit der nächsten Zeile fort, ansonsten springen Sie weiter zur übereinstimmenden %else, %elif, oder %endif Anweisung. Beispiel:
%ifdef _USTN_ROLECFG |
| %ifndef | %ifndef<cfgvar> | Wenn <cfgvar> nicht definiert ist, fahren Sie mit der nächsten Zeile fort, ansonsten springen Sie weiter zur übereinstimmenden %else, %elif, oder %endif Anweisung. Beispiel:
%ifndef MS_DEF |
| %else | %else | Ein %if, %ifdef, oder %ifndef Anweisung, dass als "falsch" ausgewertet wird, findet sich in der Zeile nach einer übereinstimmenden %else-Anweisung, falls vorhanden. |
| %elif | %elif <expression> | Eine %if, %ifdef, oder %ifndef-Anweisung, die als "falsch" ausgewertet wird, setzt sich fort, indem sie <expression> bei der ersten übereinstimmenden %elif-Anweisung auswertet, und dann entweder die Verarbeitung in der folgenden Zeile fortsetzt, wenn der Ausdruck als "wahr" ausgewertet wird, oder springt weiter zur nächsten %elif, %else, oder %endifAnweisung. Beispiel:
%elif defined (MS_RFDIR) |
| %endif | %endif | Die Anweisung, die das Ende des bedingten Blocks für eine %if, %ifdef, oder %ifndef Anweisung angibt. |
| %echo | %echo<message> | Zeigt den Inhalt vom <message> im MicroStationTextfenster an, und setzt die Verarbeitung fort. Beispiel:
%echo $(MS_DEF) |
| %error | %error<message> | Hält die Verarbeitung an und meldet die Inhalte von <message> als Fehler. Beispiel:
%error unexpected value |
Variablen-Direktiven
Folgende Variablen-Direktiven werden unterstützt: