Difference between revisions of "LlName2Key"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 1: Line 1:
{{Issues/SVC-215}}
{{KBnote|This function is coming soon but is not yet available.}}
{{LSL_Function
{{LSL_Function
|func_id
|mode=request
|func_sleep=0.1
|func_energy=10.0
|func=llNameToKey
|func=llNameToKey
|sort=NameToKey
|sort=NameToKey
|return_type=key
|return_type=key
|p1_type=string|p1_name=name|p1_desc=the Legacy Name of the avatar to retrieve the UUID of.
|p1_type=string|p1_name=name|p1_desc=Name of the avatar to retrieve the UUID of.
|return_text=that is the UUID of the avatars with '''name''' as their Legacy Name, if they are in the same sim that the script is in.
|return_text=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 <nowiki>"First[ Last]" or "first[.last]"</nowiki> (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.
|spec
|spec
|caveats=* Works only for agents recently located in the same sim the script is running in. To request a UUID for a non-local avatar then use [[llRequestAgentKeyByName|llRequestAgentKeyByName()]] instead.
|caveats=* This function does not operate on historical names. For historical name lookup use [[llRequestUserKey]].
|examples
|examples
|helpers
|helpers
Line 22: Line 18:
{{LSL DefineRow||[[llRequestAgentKeysByDisplayName]]}} to fetch avatar UUIDs by display-name grid-wide.
{{LSL DefineRow||[[llRequestAgentKeysByDisplayName]]}} to fetch avatar UUIDs by display-name grid-wide.
{{LSL DefineRow||[[llRequestAgentKeyByName]]}} to fetch avatar UUID by legacy-name grid-wide.
{{LSL DefineRow||[[llRequestAgentKeyByName]]}} to fetch avatar UUID by legacy-name grid-wide.
|notes=Please vote on {{jira|SVC-215}} if you would like to see this function implemented.
}}
}}

Revision as of 10:54, 6 April 2018

KBnote.png Note: This function is coming soon but is not yet available.

Summary

Function: key llNameToKey( 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.

Examples

See Also

Functions

•  llUsernameToKey to fetch avatar UUID by username.
•  llRequestAgentKeyByUsername to fetch avatar UUID by username grid-wide.
•  llDisplayNameToKeys to fetch avatar UUIDs by display-name.
•  llRequestAgentKeysByDisplayName to fetch avatar UUIDs by display-name grid-wide.
•  llRequestAgentKeyByName to fetch avatar UUID by legacy-name grid-wide.

Deep Notes

Signature

function key llNameToKey( string name );