resolve-var-syntax( a[, b] )


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.

Siehe auch