La parte de consulta de las solicitudes y las cadenas de viñeta::Modifier pueden incluir variables definidas por el usuario.
$ name = value
name
- Nombre de variable. Puede consistir en cualquier combinación de caracteres alfa, dígitos y seguros, excepto $
.
value
: valor en el que se va a configurar la variable (cadena).
Las variables se definen de forma similar a otros comandos de servidor, utilizando la sintaxis anterior. Se deben definir las variables antes de poder hacer referencia a ellas. Variables definidas en vignette::Modifier
se puede hacer referencia a en la solicitud de URL y a la inversa.
value
debe tener codificación URL de un solo paso para la transmisión HTTP segura. Se requiere codificación doble si value
se retransmite mediante HTTP. Este es el caso cuando value
se sustituye en una solicitud externa anidada.
Se hace referencia a las variables incrustando el nombre de la variable (entre una inicial y una final) $
) en cualquier lugar de los valores de comando. Por ejemplo, entre las variables =
después del nombre del comando y el siguiente &
o el final de la solicitud. El servidor sustituye cada incidencia de $ name$
con string
. No se producen sustituciones en ninguna incidencia de $ name$
en nombres de comando (antes del signo igual de un comando) y en la parte de ruta de la solicitud.
Las variables personalizadas no pueden estar anidadas. Cualquier incidencia de $ name$
dentro string
no se sustituyen. Por ejemplo, el fragmento de solicitud $var2=apple&$var1=my$var2$tree&text=$var1$
se resuelve en text=my$var2$tree
.
$
no es un carácter reservado; puede ocurrir de otra manera en la solicitud. Por ejemplo, src=my$texture$file.tif
es un comando válido (suponiendo que una entrada de catálogo de material o un fichero de textura llamado my$texture$file.tif
existe), mientras que wid=$number$
no es, porque wid=
requiere un argumento numérico.