Difference between revisions of "LlDetectedName"
Jump to navigation
Jump to search
m |
|||
| Line 1: | Line 1: | ||
{{LSL_Function/detected| | {{LSL_Function | ||
|inject-1={{LSL_Function/detected|item|name|error={{LSL Constant/NULL KEY}}}} | |||
|func_id=31|func_sleep=0.0|func_energy=10.0 | |func_id=31|func_sleep=0.0|func_energy=10.0 | ||
|sort=DetectedName | |sort=DetectedName | ||
|func=llDetectedName|return_type=string|p1_type=integer|p1_name= | |func=llDetectedName|return_type=string|p1_type=integer|p1_name=item | ||
|func_footnote=Returns {{LSL Constant/NULL KEY}} if ''' | |func_footnote=Returns {{LSL Constant/NULL KEY}} if '''{{LSL Param|item}}''' is not valid.<br> | ||
If the item detected is an avatar then the {{LSLGC|Avatar/Name|legacy name}} is returned. | |||
|func_desc | |func_desc | ||
|return_text=that is the | |return_text=that is the name of the {{LSLGC|Detected|detected}} '''{{LSL Param|item}}'''. | ||
|spec | |spec | ||
|caveats | |caveats | ||
| Line 27: | Line 29: | ||
|also_articles | |also_articles | ||
|notes | |notes | ||
|cat1 | |cat1=Avatar/Name | ||
|cat2 | |cat2=Legacy Name | ||
|cat3 | |cat3 | ||
|cat4 | |cat4 | ||
}} | }} | ||
Revision as of 12:34, 23 September 2010
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llDetectedName( integer item );| 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.
Examples
<lsl> default {
touch_start(integer num)
{
integer i = 0;
do
llSay(0, llDetectedName(i) + "'s key is " + (string) llDetectedKey(i));
while(num > ++i);
}
}
</lsl>See Also
Articles
| • | Detected |
Deep Notes
Footnotes
- ^ The exception is no_sensor but it doesn't enable llDetected* functions.
- ^ Like all event parameters, the user can overwrite the initial value.
Signature |
|---|
function string llDetectedName( integer item ); |