Difference between revisions of "LlRequestUserKey"
Jump to navigation
Jump to search
(Created page with "{{KBnote|This function is coming soon but is not yet available.}} {{LSL_Function |func=llRequestUserKey |sort=llRequestUserKey |return_type=key |p1_type=string|p1_name=usernam...") |
|||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{LSLC|Functions}} | ||
{{LSL_Function | {{LSL_Function | ||
|func=llRequestUserKey | |func=llRequestUserKey | ||
| Line 5: | Line 5: | ||
|return_type=key | |return_type=key | ||
|p1_type=string|p1_name=username|p1_desc=the username of the avatar to retrieve the UUID of. | |p1_type=string|p1_name=username|p1_desc=the username of the avatar to retrieve the UUID of. | ||
| | |func_desc=Requests the Agent ID for the agent identified by name from the dataserver. The name given may be either the current name of an avatar or a historical name that has been used in the past. If no agent can be found with the supplied name this function returns the value [[NULL_KEY]]. | ||
Returns a handle (a key) that can be used to identify the request when the dataserver event is raised. | |||
The agent being searched for with this function does not need to be signed on to Second Life. | |||
|spec | |spec | ||
|caveats | |caveats | ||
|examples | |examples=<source lang="lsl2">key name_key_query; | ||
default | |||
{ | |||
state_entry() | |||
{ | |||
name_key_query = llRequestUserKey("rider.linden"); | |||
} | |||
dataserver(key queryid, string data) | |||
{ | |||
if ( name_key_query == queryid ) | |||
{ | |||
llSay(0, "The key for this user is : " + data); | |||
} | |||
} | |||
}</source> | |||
|helpers | |helpers | ||
|related | |related | ||
|also | |also | ||
|also_functions= | |also_functions= | ||
{{LSL DefineRow||[[ | {{LSL DefineRow||[[llName2Key]]}} to fetch avatar UUID by name. | ||
|notes=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. | |notes=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. | ||
}} | }} | ||
Revision as of 12:51, 15 May 2018
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: key llRequestUserKey( string username );Requests the Agent ID for the agent identified by name from the dataserver. The name given may be either the current name of an avatar or a historical name that has been used in the past. If no agent can be found with the supplied name this function returns the value NULL_KEY.
Returns a handle (a key) that can be used to identify the request when the dataserver event is raised.
The agent being searched for with this function does not need to be signed on to Second Life.
Returns a key
| • string | username | – | the username of the avatar to retrieve the UUID of. |
Caveats
Examples
key name_key_query;
default
{
state_entry()
{
name_key_query = llRequestUserKey("rider.linden");
}
dataserver(key queryid, string data)
{
if ( name_key_query == queryid )
{
llSay(0, "The key for this user is : " + data);
}
}
}
Notes
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.
See Also
Functions
| • | llName2Key | to fetch avatar UUID by name. |