Difference between revisions of "LlSetObjectDesc"

Revision as of 18:31, 30 March 2009

Function: llSetObjectDesc( string desc );

Sets the prims description

• string

desc

The object description is limited to 127 bytes, any string longer then that will be truncated.
The pipe character | is not legal in an object's description, it will be replaced by a '?'^[1].

A

Name or description change, of an attached object, is rolled back when object is detached

<lsl>//store the owner's name in the prim description default {

   touch_start(integer total_number)
   {
       string temp;

       temp = llKey2Name(llGetOwner());

       llSetObjectDesc(temp);
   }

}</lsl>

		VWR-437	A		llSetObjectDesc and editor panel have different description string length limits
		SVC-3429	A		Name or description change, of an attached object, is rolled back when object is detached

^ This is because the pipe character historically has been used to separate fields in the serialized version of inventory.

Signature
function void llSetObjectDesc( string desc );

@@ Line 1: / Line 1: @@
-{{LSL_Function/limits}}{{LSL_Function
+{{Issues/VWR-437}}{{Issues/VWR-3429}}{{LSL_Function/limits}}{{LSL_Function
 |func=llSetObjectDesc
 |func_id=271|func_sleep=0.0|func_energy=10.0
@@ Line 8: / Line 8: @@
 |spec
 |caveats=*The object description is limited to 127 bytes, any string longer then that will be truncated.
-*According to [http://jira.secondlife.com/browse/VWR-437 VWR-437] if you set the description to longer then 256 bytes the object may no longer be rezzable. Use caution if using this field to store data.
+*The pipe character &#124; is not legal in an object's description, it will be replaced by a '?'{{Footnote|This is because the pipe character historically has been used to separate fields in the serialized version of inventory.}}.
-*The pipe character &#124; is not legal in an object's description, it will be replaced by a '?'.
-*According to [http://jira.secondlife.com/browse/SVC-3429 SVC-3429] the description field will not persist on the root prim of an attached object if detached.  It will persist if dropped.  One workaround is to store the description in a child prim which is persisted.
 |constants
 |examples=<lsl>//store the owner's name in the prim description

•	Limits	–	SL limits and constrictions
•	Prim Attribute Overloading