LlDetectedName

From Second Life Wiki

Jump to: navigation, search

Contents

Summary

Function: string llDetectedName( integer item );

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

default
{
    touch_start(integer num_detected)
    {
        key id = llDetectedKey(0);
 
        // legacy name, i.e. "John Doe" or if lastname Resident "John Resident"
        string name = llDetectedName(0);
 
        // PUBLIC_CHANNEL has the integer value 0
        llSay(PUBLIC_CHANNEL,
            "The avatar with the key'" + (string)id + "' is named '" + name + "'.");
    }
}

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.
This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.
Personal tools
In other languages