Difference between revisions of "LlUnescapeURL"

From Second Life Wiki
Jump to: navigation, search
m
m (Replaced old <LSL> block with <source lang="lsl2">)
 
Line 12: Line 12:
 
|constants
 
|constants
 
|examples=
 
|examples=
<lsl>
+
<source lang="lsl2">
 
string str = "http://wiki.secondlife.com/wiki/LSL Portal";
 
string str = "http://wiki.secondlife.com/wiki/LSL Portal";
  
Line 37: Line 37:
 
     }
 
     }
 
}
 
}
</lsl>
+
</source>
 
|helpers
 
|helpers
 
|also_functions={{LSL DefineRow||[[llEscapeURL]]| Opposite of llUnescapeURL}}
 
|also_functions={{LSL DefineRow||[[llEscapeURL]]| Opposite of llUnescapeURL}}

Latest revision as of 11:09, 22 January 2015

Summary

Function: string llUnescapeURL( string url );

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

• string url A (preferably valid and escaped URL) string.
This function is similar to functions (e.g. urldecode, decodeURIComponent) found in many other languages: 
PHP
urldecode
ECMAScript
decodeURIComponent

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.
All Issues ~ Search JIRA for related Bugs

Examples

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"
    }
}

See Also

Functions

•  llEscapeURL Opposite of llUnescapeURL

Articles

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

Deep Notes

Search JIRA for related Issues

Signature

function string llUnescapeURL( string url );