resolve-var-syntax( a[, b] )
|
Gruppe |
Ersetzt in dem Text a die Variablen-Platzhalter der Form @VAR_NAME@ durch den Wert der Variablen VAR_NAME wenn, und nur wenn diese Variable im Profil definiert ist. Andernfalls wird nichts ersetzt. Der Rückgabewert der Funktion ist der Text mit den aufgelösten Variablenwerten. Wenn der Parameter b den Wert true hat, werden zusätzlich die Datums- und Zeit-Symbole, z. B. <yyyy> für die vierstellige Jahreszahl des aktuellen Jahres ersetzt. In dem Text a können mehrere Variablen enthalten sein. Sie werden alle ersetzt, sofern die entsprechende Variable definiert war.
Wenn der Variablen-Wert selbst wieder einen Variablen-Platzhalter der Form @VAR_NAME2@ enthält, muss diese Funktion für den Rückgabewert des ersten Aufrufs erneut aufgerufen werden, um die Auflösung des im Wert enthaltenen Variablen-Platzhalters zu garantieren. Falls doch schon im ersten Aufruf die Auflösung erfolgt, wäre das zufällig.
Parameterbeschreibung
|
Parameter |
Beschreibung |
|
a |
Der Text, in dem Variablen-Platzhalter aufgelöst werden sollen. |
|
b |
(optional) true, wenn Datums- und Zeit-Symbole ebenfalls aufgelöst werden sollen. Default: false. |
Beispiele
|
Parameter a |
Parameter b |
Ergebnis |
Bemerkung |
|
Hallo Welt! |
beliebig |
Hallo Welt! |
Keine Ersetzung notwendig. |
|
Hallo @VAR_ZIEL@! |
beliebig |
Hallo Welt! |
Wenn VAR_ZIEL definiert ist und den Wert Welt hat. |
|
@VAR_GRUSS@ @VAR_ZIEL@! |
beliebig |
Hi all! |
Wenn VAR_GRUSS den Wert Hi und VAR_ZIEL den Wert all hat. |
|
@VAR_GRUSS@ @VAR_ZIEL@! |
beliebig |
Hi @VAR_ZIEL@! |
Wenn VAR_GRUSS den Wert Hi hat und VAR_ZIEL nicht definiert ist. |
|
Es ist <HH>:<mm> Uhr. |
true |
Es ist 15:19 Uhr |
Falls es nach Systemzeit gerade 15:19 Uhr ist. |
|
Es ist <HH>:<mm> Uhr. |
nicht true |
Es ist <HH>:<mm> Uhr |
Keine Zeitauflösung gewünscht. |