Benutzerdefinierte Variablen custom-variables

Der Abfrageabschnitt der Anforderungen und die Vignetten::Modifier-Zeichenfolgen kann benutzerdefinierte Variablen enthalten.

$ name = value

name - Variablenname. Kann aus einer beliebigen Kombination aus alphanumerischen, numerischen und sicheren Zeichen bestehen, mit Ausnahme von $.

value - Wert, auf den die Variable festgelegt werden soll (Zeichenfolge).

Variablen werden ähnlich wie andere Serverbefehle unter Verwendung der oben genannten Syntax definiert. Variablen müssen definiert werden, bevor sie referenziert werden können. Variablen, die in vignette::Modifier definiert sind, können in der URL-Anforderung referenziert werden und umgekehrt.

Variablen werden referenziert, indem der Variablenname (eingeschlossen durch einen vorangestellten und nachfolgenden $) an einer beliebigen Stelle in Befehlswerte eingebettet wird. Beispielsweise zwischen dem =, das auf den Befehlsnamen folgt, und dem nachfolgenden & oder dem Ende der Anfrage. Der Server ersetzt jedes Vorkommen von $ name$ durch string. Bei Instanzen von $ name$ in Befehlsnamen (vor dem Gleichheitszeichen eines Befehls) und im Pfadabschnitt der Anfrage erfolgt kein Ersatz.

Benutzerdefinierte Variablen sind möglicherweise nicht verschachtelt. Alle Vorkommnisse von $ name$ innerhalb von string werden nicht ersetzt. Beispielsweise wird das Anforderungsfragment $var2=apple&$var1=my$var2$tree&text=$var1$ in text=my$var2$tree aufgelöst.

$ ist kein reserviertes Zeichen; es kann andernfalls in der Anfrage auftreten. Beispiel: src=my$texture$file.tif ist ein gültiger Befehl (vorausgesetzt, dass ein Materialkatalogeintrag oder eine Texturdatei mit dem Namen my$texture$file.tif vorhanden ist), während wid=$number$ nicht ist, da wid= ein numerisches Argument erfordert.