llGetAttachedList

From Second Life Wiki
Revision as of 17:39, 24 September 2024 by Lucia Nightfire (talk | contribs) (List of keys returned is ordered by rez/attach time from oldest to newest.)
Jump to navigation Jump to search

Summary

Function: list llGetAttachedList( key avatar );

Returns a list of object keys corresponding to public attachments worn by an avatar in the order they were attached.

• key avatar avatar UUID that is in the same region

By design HUD attachment keys are not reported by this function.

If avatar is a child agent, ["NOT ON REGION"] is returned.
If avatar is not a main agent and not a child agent or not an agent at all, ["NOT FOUND"] is returned.

Caveats


When an avatar first arrives in a region, there is a brief period when their attachments are not yet fully rezzed or added. During this time, those attachments will not appear in the results.

Examples

// Touch to list all attachments

default
{
    touch_start(integer total_number)
    {
        list AttachedNames;
        list AttachedUUIDs = llGetAttachedList(llDetectedKey(0));
        integer i;
        while (i < llGetListLength(AttachedUUIDs) )
        {
            list temp = llGetObjectDetails(llList2Key(AttachedUUIDs,i),[OBJECT_NAME]);
            AttachedNames += [llList2String(temp,0)];
            ++i;
        }
        llSay(PUBLIC_CHANNEL,"\n" + llDumpList2String(AttachedNames,"\n"));
    }
}

See Also

Deep Notes

History

• 20/Dec/08 SVC-3560 llQueryAvatarAttachments Suggested
• 30/Apr/13 BUG-2467 llGetAttachedList Suggested
• 14/Jul/15 BUG-9683 llGetAttachedList Suggested again

Signature

function list llGetAttachedList( key avatar );