Linkset Data

Store key-value data in a linkset and respond to changes.

Feature: Data Storage

What do you want to do?

integer llLinksetDataWrite(string name, string value)Creates or updates an unprotected key-value pair (name and value) in the linkset's datastore. Returns an integer success or failure code.string llLinksetDataRead(string name)Reads and returns the string value corresponding to key name from the linkset's datastore.list llLinksetDataFindKeys(string pattern, integer start, integer count)Returns an alphabetically sorted list of up to count keys from the datastore that match the regular expression pattern, starting at index start (returns all matching keys if count < 1).integer llLinksetDataDelete(string name)Deletes the unprotected key-value pair specified by name from the linkset's datastore, triggering a linkset_data event.

Reference

Find topic entries

14 topic entries

• integer llLinksetDataAvailable()function

  Returns an integer representing the number of bytes available/remaining in the linkset's datastore.

• integer llLinksetDataCountFound(string pattern)function

  Returns the total count of keys in the linkset datastore that match the regular expression pattern.

• integer llLinksetDataCountKeys()function

  Returns an integer representing the total number of unique keys stored in the linkset's datastore.

• integer llLinksetDataDelete(string name)function

  Deletes the unprotected key-value pair specified by name from the linkset's datastore, triggering a linkset_data event.

• list llLinksetDataDeleteFound(string pattern, string pass)function

  Deletes all keys in the datastore matching the regular expression pattern. Returns a list [num_deleted, num_failed_protected]. Decrypts and deletes protected keys if matching pass is provided.

• integer llLinksetDataDeleteProtected(string name, string pass)function

  Deletes the protected key-value pair specified by name from the linkset's datastore using the passphrase pass, triggering a linkset_data event.

• list llLinksetDataFindKeys(string pattern, integer start, integer count)function

  Returns an alphabetically sorted list of up to count keys from the datastore that match the regular expression pattern, starting at index start (returns all matching keys if count < 1).

• list llLinksetDataListKeys(integer start, integer count)function

  Returns an alphabetically sorted list of up to count keys from the datastore, starting at index start (returns all keys if count < 1).

• string llLinksetDataRead(string name)function

  Reads and returns the string value corresponding to key name from the linkset's datastore.

• string llLinksetDataReadProtected(string name, string pass)function

  Reads and returns the string value of the protected key name from the linkset's datastore using the passphrase pass.

• llLinksetDataReset()function

  Erases all key-value pairs stored in the linkset's datastore, triggering a linkset_data event (with LINKSETDATA_RESET) in all scripts in the linkset.

• integer llLinksetDataWrite(string name, string value)function

  Creates or updates an unprotected key-value pair (name and value) in the linkset's datastore. Returns an integer success or failure code.

• integer llLinksetDataWriteProtected(string name, string value, string pass)function

  Creates or updates a protected key-value pair (name and value) in the linkset's datastore using the passphrase pass. Returns an integer success or failure code.

• linkset_data(integer action, string name, string value)event

  Fires in all scripts in the linkset whenever the datastore has been modified via an llLinksetData function. Passes the action taken, the affected key name, and the new value.