Difference between revisions of "LlLinksetDataDelete"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 1: Line 1:
{{LSL_Function
{{LSL Function/Headless
|default={{{default|}}}
|inject-2=
|summary=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 [[Template:LSL_Constants_Linkset_Data|LINKSETDATA_DELETE]] and the '''name''' parameter set to the {{LSLP|name}} that was removed. The '''value''' parameter in the event is set to an empty string.
 
|func=llLinksetDataDelete|sort={{{sort|LinksetDataDelete}}}
|head={{LSL Function/Head
|func_id=|func_sleep=0|func_energy=10.0
|func=llLinksetDataDelete
|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
}}{{LSL_Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=llLinksetDataDelete
|func=llLinksetDataDeleteProtected
|func_footnote
|func_footnote
|func_desc=The '''llLinksetDataDelete''' function erases a '''key:value''' pair from the linkset's datastore.
|func_desc=The '''llLinksetDataDeleteProtected''' function erases a protected '''name:value''' pair from the linkset's datastore.  


When this function is called the [[linkset_data]] event is triggered in all scripts running in the linkset with an action of [[Template:LSL_Constants_Linkset_Data|LINKSETDATA_DELETE]] and the name parameter set to the {{LSLP|key}} that was removed. The '''value''' parameter in the event is set to an empty string.
|func_footnote
|func_footnote
|p1_type=string|p1_name=key|p1_desc=The '''key''' of the linkset '''key: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.
|spec
|spec
|caveats=If the {{LSLP|key}} does not exist, no event is triggered.
}}
|caveats=If the {{LSLP|name}} does not exist or the {{LSLP|pass}} does not match, no event is triggered.
|helpers
|helpers
|also_functions=
|also_functions=
Line 17: Line 31:
{{LSL DefineRow||[[llLinksetDataListKeys]]|}}
{{LSL DefineRow||[[llLinksetDataListKeys]]|}}
{{LSL DefineRow||[[llLinksetDataRead]]|}}
{{LSL DefineRow||[[llLinksetDataRead]]|}}
{{LSL DefineRow||[[llLinksetDataReadProtected]]|}}
{{LSL DefineRow||[[llLinksetDataReset]]|}}
{{LSL DefineRow||[[llLinksetDataReset]]|}}
{{LSL DefineRow||[[llLinksetDataWrite]]|}}
{{LSL DefineRow||[[llLinksetDataWrite]]|}}
{{LSL DefineRow||[[llLinksetDataWriteProtected]]|}}
|also_events=
|also_events=
{{LSL DefineRow||[[linkset_data]]}}
{{LSL DefineRow||[[linkset_data]]}}

Revision as of 10:08, 17 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: llLinksetDataDelete( string name );

Removes an unprotected name:value pair from the linkset's datastore. If the pair was created

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

llLinksetDataDeleteProtected

Function: 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.

• 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.

Caveats

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

Examples

Deep Notes

Signature

function void llLinksetDataDelete( string name );
function void llLinksetDataDeleteProtected( string name, string pass );