llLinksetDataDeleteFound
list llLinksetDataDeleteFound(string search, string pass)Deletes all key value pairs in the linkset data where the key matches the regular expression in search. Returns a list consisting of [ #deleted, #not deleted ].
Parameters
-
search(string) - A regex search string to match against keys in the datastore.
-
pass(string) - The pass phrase used to protect key value pairs in the linkset data
The llLinksetDataDeleteFound function finds and attempts to delete all keys in the linkset data store that match the provided regular expression pattern. This function will delete protected key-value pairs only if the matching pass phrase is provided in the pass parameter.
Return Value
Section titled “Return Value”The function returns a list containing:
- [0] - Number of keys successfully deleted
- [1] - Number of keys that could not be deleted (due to non-matching pass phrase)
Behavior
Section titled “Behavior”If this function successfully deletes any keys from the datastore, it will trigger a linkset_data event with the type LINKSET_DATA_MULTIDELETE. The event’s key name will consist of a comma-separated list of the key names removed from the datastore.
- The
patternparameter is a regular expression - Protected keys can only be deleted if the correct pass phrase is provided
- This is a powerful operation - use carefully to avoid accidental data loss
- The function triggers a linkset_data event for all deletions made