LlDetectedName

Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el 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

DetectedName

llDetectedName

Summary

Function: string llDetectedName( integer item );

31	Function ID
0.0	Forced Delay
10.0	Energy

Returns a string that is the name of the detected item.

• integer

item

–

Index of detection information

item does not support negative indexes. Returns NULL_KEY if item is not valid.
If the item detected is an avatar then the legacy name is returned.

Specification

llDetected* functions only work if called from within Detection events (collision, collision_start, collision_end, sensor, touch, touch_start, touch_end) or in functions called by Detection events. They will fail silently and return unusable values if called during other events.

Caveats

• If item is out of bounds this function returns NULL_KEY and the script continues to execute without an error message.
• Events that enable the llDetected* functions always return at least one detected item.
  • Detection events are not raised if there is nothing detected.^[1]
  • The detection event's items detected parameter is initially never less than 1.^[2]

All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   touch_start(integer num_detected)
   {
       key    id   = llDetectedKey(0);
       string name = llDetectedName(0);// could use llKey2Name(id) here instead

// name is the legacy name, i.e. "John Doe" or if lastname Resident "John Resident"

       llSay(PUBLIC_CHANNEL,
           "The avatar with the key'" + (string)id + "' is named '" + name + "'.");
   }

}

</lsl>

See Also

Articles

•

Detected

Deep Notes

Search JIRA for related Issues

Footnotes

1. ^ The exception is no_sensor but it doesn't enable llDetected* functions.
2. ^ Like all event parameters, the user can overwrite the initial value.

Signature
function string llDetectedName( integer item );