Variabili personalizzate

La porzione query delle richieste e della vignetta::Le stringhe dei modificatori possono includere variabili definite dall'utente.

$ *name*= *value*

name Nome della variabile. Può essere costituita da qualsiasi combinazione di caratteri alfa, cifra e sicuri, escluso '$.'

value Valore a cui impostare la variabile (stringa).

Le variabili sono definite in modo simile ad altri comandi del server, utilizzando la sintassi riportata sopra. Prima di poter fare riferimento alle variabili, è necessario definirle. Le variabili definite in vignette::Modifier possono essere referenziate nella richiesta URL e viceversa.

NOTA

value devono essere codificati in URL a passa singolo per una trasmissione HTTP sicura. La doppia codifica è necessaria se value viene ritrasmessa tramite HTTP. Questo è il caso in cui value viene sostituito in una richiesta esterna nidificata.

Per fare riferimento alle variabili, incorpora il nome della variabile (racchiuso da un $ iniziale e finale) in qualsiasi punto dei valori di comando. Ad esempio, tra '=' che segue il nome del comando e il successivo '&' o la fine della richiesta. Il server sostituisce ogni occorrenza di $ name$ con string. Non si verificherà alcuna sostituzione in caso di occorrenze di $ name$ nei nomi dei comandi (prima del segno uguale di un comando) e nella parte del percorso della richiesta.

Le variabili personalizzate potrebbero non essere nidificate. Tutte le occorrenze di $ name$ all'interno di string non vengono sostituite. Ad esempio, il frammento di richiesta $var2=apple&$var1=my$var2$tree&text=$var1$ viene risolto in text=my$var2$tree.

$ non è un carattere riservato; potrebbe verificarsi altrimenti nella richiesta. Ad esempio, src=my$texture$file.tif è un comando valido (supponendo che esista una voce di catalogo dei materiali o un file di texture denominato my$texture$file.tif esiste), mentre wid=$number$ non lo è, perché wid= richiede un argomento numerico.

In questa pagina