Difference between revisions of "LlName2Key"

From Second Life Wiki
Jump to navigation Jump to search
m (Replaced <source> with <syntaxhighlight>, added sleep/energy as well as a short comment on what the example should return, and added the obligatory haiku (thanks to Poem Generator!))
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{KBnote|This function is coming soon but is not yet available.}}
[[Category:LSL_Functions]]
{{LSL_Function
{{LSL_Function
|func=llName2Key
|func=llName2Key|func_sleep=0.0|func_energy=0.0
|sort=NameToKey
|sort=NameToKey
|return_type=key
|return_type=key
Line 8: Line 8:
|spec
|spec
|caveats=* This function does not operate on historical names. For historical name lookup use [[llRequestUserKey]].
|caveats=* This function does not operate on historical names. For historical name lookup use [[llRequestUserKey]].
|examples
|examples=<syntaxhighlight lang="lsl2">tellName2Key(string avatarName)
{
    key keyFromName = llName2Key(avatarName);
    if (keyFromName == NULL_KEY)
    {
        llSay(0, "There is no agent with the name '" + avatarName + "' currently signed onto the region.");
        return;
    }
    llSay(0, "Avatar key for name '" + avatarName + "': " + (string)keyFromName);
}
 
default
{
    touch_start(integer total_number)
    {
        tellName2Key("rider.linden");
        tellName2Key("Rider Linden");
        tellName2Key(llDetectedName(0));
    }
}
// If Rider Linden touches the object, the three lines should contain the answer c5a07167-9bbe-4944-a7b0-a9677afa134d
</syntaxhighlight>
|helpers
|helpers
|haiku={{Haiku|Glorious high noon|A last, tiny name converts|in spite of the key}}
|related
|related
|also
|also

Latest revision as of 15:49, 7 April 2022

Summary

Function: key llName2Key( string name );

Returns a key the Agent ID for the named agent in the region. If there is no agent with the specified name currently signed onto the region, this function returns the value NULL_KEY. Names are always provided in the form "First[ Last]" or "first[.last]" (first name with an optional last name.) If the last name is omitted a last name of "Resident" is assumed. Case is not considered when resolving agent names.

• string name Name of the avatar to retrieve the UUID of.

Caveats

  • This function does not operate on historical names. For historical name lookup use llRequestUserKey.
All Issues ~ Search JIRA for related Bugs

Examples

tellName2Key(string avatarName)
{
    key keyFromName = llName2Key(avatarName);
    if (keyFromName == NULL_KEY)
    {
        llSay(0, "There is no agent with the name '" + avatarName + "' currently signed onto the region.");
        return;
    }
    llSay(0, "Avatar key for name '" + avatarName + "': " + (string)keyFromName);
}

default
{
    touch_start(integer total_number)
    {
        tellName2Key("rider.linden");
        tellName2Key("Rider Linden");
        tellName2Key(llDetectedName(0));
    }
}
// If Rider Linden touches the object, the three lines should contain the answer c5a07167-9bbe-4944-a7b0-a9677afa134d

See Also

Functions

•  llRequestUserKey to fetch avatar UUID by current or historical username.

Deep Notes

Search JIRA for related Issues

Signature

function key llName2Key( string name );

Haiku

Glorious high noon
A last, tiny name converts
in spite of the key