Difference between revisions of "LlEscapeURL"

From Second Life Wiki
Jump to: navigation, search
m
(stupid script, but anyway)
Line 8: Line 8:
 
|caveats=* The function is not appropriate for escaping a URL all at once because the ':' after the protocol and all of the '/' characters delimiting the various parts will be escaped.  Instead, build the URL in parts, escaping parts of the path and query string arguments as needed.  
 
|caveats=* The function is not appropriate for escaping a URL all at once because the ':' after the protocol and all of the '/' characters delimiting the various parts will be escaped.  Instead, build the URL in parts, escaping parts of the path and query string arguments as needed.  
 
|constants
 
|constants
|examples
+
|examples=<lsl>//provides a clickable link to the LSL Portal by escaping the space in the title
 +
 
 +
string title = "LSL Portal";
 +
 
 +
default{
 +
    state_entry(){
 +
        llOwnerSay("http://wiki.secondlife.com/wiki/" + llEscapeURL(title));
 +
    }
 +
}</lsl>
 
|helpers
 
|helpers
 
|also_functions={{LSL DefineRow|[[llUnescapeURL]]}}
 
|also_functions={{LSL DefineRow|[[llUnescapeURL]]}}

Revision as of 10:40, 10 August 2009

Summary

Function: string llEscapeURL( string url );

Returns a string that is the escaped/encoded version of url, replacing spaces with %20 etc. The function will escape any character not in [a-zA-Z0-9] to %xx where xx is the hexadecimal value of the character in UTF-8 byte form.

• string url

To clarify, numbers and ASCII7 alphabetical characters are NOT escaped. If a character requires more then one byte in UTF-8 byte form then it returns multiple %xx sequences chained together.

Caveats

  • The function is not appropriate for escaping a URL all at once because the ':' after the protocol and all of the '/' characters delimiting the various parts will be escaped. Instead, build the URL in parts, escaping parts of the path and query string arguments as needed.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl>//provides a clickable link to the LSL Portal by escaping the space in the title

string title = "LSL Portal";

default{

   state_entry(){
       llOwnerSay("http://wiki.secondlife.com/wiki/" + llEscapeURL(title));
   }
}</lsl>

See Also

Functions

• llUnescapeURL

Articles

• UTF-8
• Base64

Deep Notes

History

  • Prior to SL versions 1.19.1.81992, this function was limited to returning a maximum of 254 characters. SVC-470

Search JIRA for related Issues

Signature

function string llEscapeURL( string url );