Difference between revisions of "LlGetDisplayName"
m |
|||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-1={{LSL Function/avatar|id|sim=*}}{{LSL Generic/pre-release|server-release=[[Display Names|DisplayNames]]}} | |inject-1={{LSL Function/avatar|id|sim=*}}{{LSL Generic/pre-release|server-release=[[Display Names|DisplayNames]]}} | ||
{{LSL_Function/warning|Security|It is ''' | {{LSL_Function/warning|Security|It is a '''terrible''' idea to tie any security measures to display names. Don't do it.}} | ||
|func_id=NNN|func_sleep=0.0|func_energy=10.0 | |func_id=NNN|func_sleep=0.0|func_energy=10.0 | ||
|sort=GetDisplayName|func=llGetDisplayName | |sort=GetDisplayName|func=llGetDisplayName | ||
Revision as of 21:31, 29 October 2010
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
|
Pre-release Documentation Warning! |
|
This function is not available yet. This documentation was written prior to its final release so it may not match the final implementation.It is slated for release in Server DisplayNames. |
|
|
Security Warning! |
|
It is a terrible idea to tie any security measures to display names. Don't do it. |
Summary
Function: string llGetDisplayName( key id );| NNN | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a string that is the non-unique display name of the avatar specified by id.
| • key | id | – | avatar UUID that is in the same region |
id must specify a valid avatar key, present in or otherwise known to the sim in which the script is running, otherwise an empty string is returned. This function will still return a valid display name if the avatar is a child agent of the sim (i.e., in an adjacent sim, but presently able to see into the one the script is in), or for a short period after the avatar leaves the sim (specifically, when the client completely disconnects from the sim, either as a main or child agent).
Caveats
- To get around the "avatar must be present" limitation, you can use the llRequestDisplayName function and the dataserver event to obtain the avatar's display name from a key.
- There is no opposite function (llDisplayName2Key) available since display names are non-unique
- "" is returned if the region is unable to return display names. Do not rely on this function to verify avatar presence.
Examples
<lsl>// Best viewed in Chat History (ctrl-h) default {
collision_start(integer a)//Announce who collided
{
llSay(0, "llGetDisplayName: " + llGetDisplayName(llDetectedKey(0)) +
"\nllDetectedName: " + llDetectedName(0));
}
touch_start(integer a)
{
llSay(0,"llGetDisplayName: " + llGetDisplayName(llDetectedKey(0)) +
"\nllDetectedName: " + llDetectedName(0));
}
}</lsl>
See Also
Functions
| • | llGetUsername | |||
| • | llRequestDisplayName | – | Uses the dataserver to request avatar information |