Jump to content

LlGetLinkName

From OSgrid Wiki

Function: string llGetLinkName( integer linknum );

Returns a string that is the name of linknum in link set
• integer linknum – Link number (0: unlinked, 1: root prim, >1: child 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
LINK_ALL_CHILDREN -3 sends to all children, (everything but the root)
LINK_THIS -4 sends to the prim the script is in


Caveats
• The prim name attribute is limited to 63 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

<source lang="lsl">

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 + "\"");
       }
   }

} </source>


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