Difference between revisions of "LlSetObjectName"

From Second Life Wiki
Jump to navigation Jump to search
m (Added sort= to hopefully get it back to the right place in the function category)
(clarified behavior when called from a child prim.)
Line 7: Line 7:
|p1_name=name
|p1_name=name
|func_desc=Sets the prim's name according to the '''name''' parameter.
|func_desc=Sets the prim's name according to the '''name''' parameter.
|func_footnote=
|func_footnote=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.
|return_text
|return_text
|spec
|spec

Revision as of 10:15, 27 December 2007

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

  1. The LL server did not reliably store more than 255 bytes of prim name. Longer prim names appeared cut short, sometimes much later than the first few calls of llSetObjectName and llGetObjectName.
  2. The LL client did not reliably edit more than 63 bytes. Longer prim names appeared cut short, e.g., as the name of the prim speaking in the Chat History of llOwnerSay messages.
  3. The LL client did not reliably show the current name. Misleadingly old names sometimes appeared at Edit > General > Name until you closed and reopened the Edit dialog of the prim.

Examples

default
{
    state_entry()
    {
        string yyyy1mm1dd = llGetDate();
        string name = yyyy1mm1dd + " " + llGetObjectName();
        llOwnerSay("llSetObjectName(\"" + name + "\")");
        llSetObjectName(name);
    }
}

See Also

Functions

•  llGetObjectName Get the prims name
•  llGetLinkName Get a linked prims name
•  llGetObjectDesc Get the prims description
•  llSetObjectDesc Set the prims description

Deep Notes

Signature

function void llSetObjectName( string name );