Difference between revisions of "LlGenerateKey"
| Line 63: | Line 63: | ||
); | ); | ||
}</lsl> | }</lsl> | ||
= Optimisation = | |||
Instead of always calling [[llGetRegionName|llGetRegionName()]], [[llGetKey|llGetKey()]], [[llGetLinkNumber|llGetLinkNumber()]], and [[llGetScriptName|llGetScriptName()]], you may wish to cache their return values into a <code>uri</code> variable, and only dynamically add the service and variable parameters each-time. Remember to update this variable when you know it's components will have changed, using the [[changed|changed()]], [[on_rez|on_rez()]], and/or [[attach|attach()]] events. | |||
{{LSLC|Examples}} | {{LSLC|Examples}} | ||
Revision as of 15:24, 12 January 2009
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: key generateKey( string service, string variable );
Generates a key using Type 3 (MD5) UUID generation to create a unique key using region-name, object-key, service and variable.
Returns a key The generated key
| • string | service | – | The service, object, function, or whatever else this key may represent. | |
| • string | variable | – | Any variable(s) relevant to the service that uniquely distinguish it. |
Examples
In a two-prim linked-set put the following script (adding generateKey where noted) into the child-prim:<lsl>integer requestID = 0;
// Add generateKey here!!
default {
touch_start(integer x) {
llMessageLinked(
LINK_ROOT,
1234,
"I am a request",
generateKey("echo", (string)requestID++)
);
}
link_message(integer x, integer y, string msg, key id) {
if (y == 1234)
llOwnerSay("Request: " + (string)id + " = " + msg);
}
}</lsl>And the following script in the root-prim:<lsl>default {
link_message(integer x, integer y, string msg, key id) {
if (y == 1234) // Echo, send straight back
llMessageLinked(x, y, msg, id);
}
}</lsl>Simply touch the child-prim to use, enjoy!
Implementation
<lsl>key generateKey(string service, string variable) {
return (key)llInsertString(
llInsertString(
llInsertString(
llInsertString(
llMD5String(
"secondlife://" + llGetRegionName() + "/" +
(string)llGetKey() + "/" +
(string)llGetLinkNumber() + "/" +
llGetScriptName() + "/" + (string)service + "/" +
variable,
0 // This is reserved by specification, will
// be increased with new/different versions.
),
8,
"-"
),
13,
"-"
),
18,
"-"
),
23,
"-"
);
}</lsl>
Optimisation
Instead of always calling llGetRegionName(), llGetKey(), llGetLinkNumber(), and llGetScriptName(), you may wish to cache their return values into a uri variable, and only dynamically add the service and variable parameters each-time. Remember to update this variable when you know it's components will have changed, using the changed(), on_rez(), and/or attach() events.