LlGetLinkName - Second Life Wiki

LlGetLinkName

From Second Life Wiki

Jump to: navigation, search

Function: string llGetLinkName( integer linknum );

145 Function ID
0.0 Delay
10.0 Energy

Returns a string that is the name of linknum in link set

• integer linknum Link number (0: unlinked, 1: root prim, >1: other prims) or a LINK_* flag
Flag Description
LINK_ROOT 1 sends to root prim in a linked set
LINK_SET -1 sends to all prims
LINK_ALL_OTHERS -2 sends to all other prims
Flag Description
LINK_ALL_CHILDREN -3 sends to all children
LINK_THIS -4 sends to the prim the script is in

Caveats

  • The prim name attribute is limited to 255 bytes, any string longer then that will be truncated. This truncation does not always happen when the attribute is set or read.

Examples

Listen on channel 10 for a name; check if a prim with that name is part of this object

 
integer check_for_prim(string name)
{
    integer i = llGetNumberOfPrims();
    for (; i >= 0; --i)
    {
        if (llGetLinkName(i) == name)
        {
            return TRUE;
        }
    }
    return FALSE;
}
default
{
    state_entry()
    {
        llListen(10, "", llGetOwner(), "");
    }
    listen(integer chan, string obj, key id, string msg)
    {
        if (check_for_prim(msg))
        {
            llOwnerSay("found a linked prim named \"" + msg + "\"");
        }
        else
        {
            llOwnerSay("this object does not have any linked prims named \"" + msg + "\"");
        }
    }
}

See Also

Functions

•  llGetLinkNumber Returns the link number of the prim the script is in.
•  llGetLinkKey Gets the instance UUID of the link
•  llGetObjectName Get the prims name
•  llSetObjectName Set the prims name
•  llGetObjectDesc Get the prims description
•  llSetObjectDesc Set the prims description
•  llGetObjectDetails

Articles

•  Prim Attribute Overloading