llGetObjectName

From Second Life Wiki
Revision as of 16:53, 8 January 2014 by Darien Caldwell (talk | contribs) (Undo revision 1186176 by Kireji Haiku (Talk))
Jump to navigation Jump to search

Summary

Function: string llGetObjectName( );

Returns a string that is the name of the prim the script is attached to.

Caveats

  • The prim name is limited to 63 bytes, any string longer than that will be truncated. This truncation does not always happen when the attribute is set or read.
KBcaution.png Important: This function does not get the name of the object's rootprim, but the name of the prim containing the script. Please use llGetLinkName(LINK_ROOT); instead.
All Issues ~ Search JIRA for related Bugs

Examples

Get this prim's name Get the root prim's name
<lsl>

default {

   state_entry()
   {
   //  PUBLIC_CHANNEL has the integer value 0
       llSay(PUBLIC_CHANNEL, "This prim's name: " + llGetObjectName() );
   }

} </lsl>

<lsl> default {

   state_entry()
   {
   //  PUBLIC_CHANNEL has the integer value 0
       llSay(PUBLIC_CHANNEL, "Root prim's name: "
           + llGetLinkName(LINK_ROOT));
   }

} </lsl>

Notes

  • This function may return "(Waiting)" sometimes.

Presumably the function queries the asset server for a predetermined time and returns "(Waiting)" if that elapses. It then silently proceeds to the next instruction. A work around therefore, might be to test object name is not "(Waiting)" after calling llGetObjectName.

See Also

Functions

•  llSetObjectName Set the prims name
•  llGetLinkName Get a linked prims name
•  llGetObjectDesc Get the prims description
•  llSetObjectDesc Sets the prims description
•  llGetObjectDetails

Articles

•  Limits SL limits and constrictions
•  Prim Attribute Overloading

Deep Notes

Search JIRA for related Issues

Signature

function string llGetObjectName();