Difference between revisions of "LlUnescapeURL"

From Second Life Wiki
Jump to navigation Jump to search
m (use the new "other language" feature)
m (added LSL Tip)
Line 10: Line 10:
**Decoding of Unicode as %u#### is not supported.
**Decoding of Unicode as %u#### is not supported.
*The + character is not decoded as a space.
*The + character is not decoded as a space.
{{LSL Tip|Combining [[llUnescapeURL]] and [[llEscapeURL]] as in [[llUnescapeURL]]([[llEscapeURL]](string URL)); will not necessarily give you the original version of the URL string back.}}
|constants
|constants
|examples=
|examples=

Revision as of 09:39, 22 October 2012

Summary

Function: string llUnescapeURL( string url );
0.0 Forced Delay
10.0 Energy

Returns a string that is an unescaped/unencoded version of url, replacing %20 with spaces etc.

• string url
This function is similar to functions (e.g. urldecode) found in many other languages: 
PHP
urldecode

Caveats

  • The hexadecimal encoded representation of UTF-8 byte encoding is the only supported means of access to non ASCII7 characters (Unicode characters).
    • Decoding of Unicode as %u#### is not supported.
  • The + character is not decoded as a space.
KBcaution.png Important: Combining llUnescapeURL and llEscapeURL as in llUnescapeURL(llEscapeURL(string URL)); will not necessarily give you the original version of the URL string back.

Examples

<lsl> string str = "http://wiki.secondlife.com/wiki/LSL Portal";

default {

   state_entry()
   {
       llOwnerSay("Plain string:\n\t" + str);
       // output: "http://wiki.secondlife.com/wiki/LSL Portal"
       llOwnerSay("Escaped string:\n\t" + llEscapeURL(str));
       // output: "http%3A%2F%2Fwiki%2Esecondlife%2Ecom%2Fwiki%2FLSL%20Portal"
       llOwnerSay("Escaped string unescaped again:\n\t" + llUnescapeURL( llEscapeURL(str) ));
       // output: "http://wiki.secondlife.com/wiki/LSL Portal"
       // because escaping and unescaping are exact opposite
       // and unescaping an escaped string returns the original


       //  For readability's sake it would make more sense to do:
       llOwnerSay("For readability's sake:\n\t" + "http://wiki.secondlife.com/wiki/" + llEscapeURL("LSL Portal"));
       // output: "http://wiki.secondlife.com/wiki/LSL%20Portal"
   }

}

</lsl>

See Also

Functions

•  llEscapeURL Opposite of llUnescapeURL

Articles

•  UTF-8
•  Base64
•  Combined Library: UnicodeIntegerToUTF8 Easily convert unicode character codes to string form.

Deep Notes

Signature

function string llUnescapeURL( string url );