Difference between revisions of "LlLinksetDataDelete"

From Second Life Wiki
Jump to navigation Jump to search
Line 10: Line 10:
|func_id=|func_sleep=0|func_energy=10.0
|func_id=|func_sleep=0|func_energy=10.0
|func=llLinksetDataDelete
|func=llLinksetDataDelete
|return_type=integer
|return_text=success or failure code.
|p1_type=string|p1_name=name|p1_desc=The key of the linkset '''name:value''' pair to be deleted.
|p1_type=string|p1_name=name|p1_desc=The key of the linkset '''name:value''' pair to be deleted.
|func_desc=Removes an unprotected '''name:value''' pair from the linkset's datastore. If the pair was created  
|func_desc=Removes an unprotected '''name:value''' pair from the linkset's datastore. If the pair was created  
Line 19: Line 21:


|func_footnote
|func_footnote
|return_type=integer
|return_text=success or failure code.
|p1_type=string|p1_name=name|p1_desc=The key of the linkset '''name:value''' pair to be deleted.
|p1_type=string|p1_name=name|p1_desc=The key of the linkset '''name:value''' pair to be deleted.
|p2_type=string|p2_name=pass|p2_desc=A pass phrase previously used to protect the '''name:value''' pair.
|p2_type=string|p2_name=pass|p2_desc=A pass phrase previously used to protect the '''name:value''' pair.
|spec
|spec
}}
}}
|caveats=If the {{LSLP|name}} does not exist or the {{LSLP|pass}} does not match, no event is triggered.
|caveats=
* If the {{LSLP|name}} does not exist or the {{LSLP|pass}} does not match, no event is triggered.
|constants={{LSL Constants Linkset_Data Returns}}
|helpers
|helpers
|also_functions=
|also_functions=

Revision as of 08:32, 26 October 2022

Summary

Summary: llLinksetDataDelete, llLinksetDataDeleteProtected

The llLinksetDataDelete and llLinksetDataDeleteProtected functions erases a name:value pair from the linkset's datastore.

When this function successfully removes a name:value pair a linkset_data event is triggered in all scripts running in the linkset with an action of LINKSETDATA_DELETE and the name parameter set to the name that was removed. The value parameter in the event is set to an empty string.

llLinksetDataDelete

Function: integer llLinksetDataDelete( string name );

Removes an unprotected name:value pair from the linkset's datastore. If the pair was created
Returns an integer success or failure code.

• string name – The key of the linkset name:value pair to be deleted.

llLinksetDataDeleteProtected

Function: integer llLinksetDataDeleteProtected( string name, string pass );
0.0 Forced Delay
10.0 Energy

The llLinksetDataDeleteProtected function erases a protected name:value pair from the linkset's datastore.
Returns an integer success or failure code.

• string name – The key of the linkset name:value pair to be deleted.The key of the linkset name:value pair to be deleted.
• string pass – A pass phrase previously used to protect the name:value pair.

Constant Description
LINKSETDATA_OK 0 The name:value pair was written to the datastore.
LINKSETDATA_EMEMORY 1 A name:value pair was too large to write to the linkset datastore.
LINKSETDATA_ENOKEY 2 The name supplied to llLinksetDataWrite was empty.
LINKSETDATA_EPROTECTED 3 The name:value pair has been protected from overwrite in the linkset's datastore.
LINKSETDATA_NOTFOUND 4 The named key could not be found in the linkset's datastore when attempting to delete it.
LINKSETDATA_NOUPDATE 5 The name:value stored in the linkset was not changed by the write operation because the value stored matches the value written.

Caveats

  • If the name does not exist or the pass does not match, no event is triggered.

Examples

Deep Notes

Signature

function integer llLinksetDataDelete( string name );
function integer llLinksetDataDeleteProtected( string name, string pass );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlLinksetDataDelete&oldid=1212706"