Difference between revisions of "LlLinksetDataDelete"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
All Issues ~ Search JIRA for related Bugs
All Issues ~ Search JIRA for related Bugs
Rider Linden (talk | contribs) |
Rider Linden (talk | contribs) |
||
| 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 09:32, 26 October 2022
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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 );| ? | Function ID |
| 0 | Forced Delay |
| 10.0 | Energy |
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 );| ? | Function ID |
| 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
See Also
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function integer llLinksetDataDelete( string name ); function integer llLinksetDataDeleteProtected( string name, string pass ); |