llGenerateKey

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GenerateKey

llGenerateKey

Summary

Function: key llGenerateKey( );

	Forced Delay
	Energy

Generates a key using Version 5 (SHA-1 hash) UUID generation to create a unique key.
Returns the key generated.

Caveats

• The specific UUID version is an implementation detail that has changed in the past and may change again in the future. Do not depend upon the UUID that is returned to be Version 5.
• As the UUID produced is versioned, it should never return a value of NULL_KEY.

Examples

<lsl> default {

   touch_start(integer num_detected)
   {
       // avatar touching
       key avatarKey = llDetectedKey(0);
       string avatarName = llKey2Name(avatarKey);

       // key of the owner
       key owner = llGetOwner();

       // generated random key
       key random = llGenerateKey();

       // number of objects inside the same prim
       integer numberOfObjects = llGetInventoryNumber(INVENTORY_OBJECT);

       if (numberOfObjects)
       {
           // name of first object sorted by name inside the prim's inventory
           string itemName = llGetInventoryName(INVENTORY_OBJECT, 0);
   
           llGiveInventory(avatarKey, itemName);
           llInstantMessage(avatarKey, "Your transaction key is '" + (string)random + "'.");
   
           llInstantMessage(owner, "Transaction record:\n"
               + "receiver: " + avatarName + " (" + (string)avatarKey + ")\n"
               + "item: " + itemName + "\n"
               + "transaction key: " + (string)random);
       }
       else
       {
           // PUBLIC_CHANNEL has the integer value 0
           llSay(PUBLIC_CHANNEL, "No items to give away, sorry!");
       }
   }

}

</lsl>

Deep Notes

History

• Inspired by the library function generateKey.
• Changed from using Version 3 (MD5 hash) to Version 5 (SHA-1 hash). Date of this change is unknown.

Signature
function key llGenerateKey();