llSetObjectName

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

SetObjectName

llSetObjectName

Summary

Function: llSetObjectName( string name );

0.0	Forced Delay
10.0	Energy

Sets the prim's name according to the name parameter.

• string

name

If this function is called from a child prim in a linked set, it will change the name of the child prim and not the root prim.

Caveats

• The name is limited to 63 characters. Longer prim names are cut short.
• Names can only consist of the 95 printable characters found in the  ASCII-7 (non-extended) character set.
  • Non-ASCII characters will be replaced with two question marks ("??").
• While an object is attached, the script cannot change the name of the object as it appears in the user's inventory.^[1]
  • Changes to the name of the root prim (with llSetObjectName for example) will not be saved to inventory; when the attachment is detached (to inventory, not dropped) this name change is discarded and the name in inventory is used instead.
  • When attachment is dropped (to the ground) and taking it into inventory, the inventory item will have the new name (not the old).
• Changes to the names of child prims will be saved back to inventory when the object is detached to inventory. They survive detachment.

Examples

<lsl> // WARNING: // // llSetObjectName(string name); sets the name of the prim containing the script. // // to set the name of a linkset's root prim use // llSetLinkPrimitiveParamsFast(LINK_ROOT, [PRIM_NAME, string name]); instead

default {

   touch_start(integer total_number)
   {
       // store owner's legacy name in the name
       // field of the prim containing the script

       string ownerLegacyName = llKey2Name(llGetOwner());

       if (llGetSubString(ownerLegacyName, -1, -1) == "s")
           llSetObjectName(ownerLegacyName + "' prim");
       else
           llSetObjectName(ownerLegacyName + "'s prim");
   }

}

</lsl>

See Also

Functions

•	llGetObjectName	–	Get the prims name
•	llGetLinkName	–	Get a linked prims name
•	llGetObjectDesc	–	Get the prims description
•	llSetObjectDesc	–	Set the prims description
•	llGetObjectDetails	–	Get a list of object details

Articles

•

Limits

–

SL limits and constrictions

Deep Notes

Footnotes

1. ^ Whether or not this is a bug is still debated, regardless LL has said they will not fix it. This behavior was first recognized as a pain point in 2006 and only confirmed to be lava-flowed more recently (2011).

Signature
function void llSetObjectName( string name );