Data Storage

key llCreateKeyValue(string k, string v)function

Starts an asynchronous transaction to create a key-value pair (k and v) associated with the script's experience. Returns a key query handle for the dataserver event. Fails with XP_ERROR_STORAGE_EXCEPTION if the key already exists.

key llDataSizeKeyValue()function

Starts an asynchronous transaction to request the used and total data storage allocated for the experience. Returns a key query handle for the dataserver event.

key llDeleteKeyValue(string k)function

Starts an asynchronous transaction to delete the key-value pair associated with key k in the experience. Returns a key query handle for the dataserver event.

key llFindNotecardTextCount(string notecardname, string pattern, list options)function

Searches the text of a cached notecard for lines containing the given pattern and returns the number of matches found through a dataserver event.

list llFindNotecardTextSync(string name, string pattern, integer start, integer count, list options)function

Synchronously searches a cached notecard name for lines containing pattern, returning a list of line and column numbers. Returns a list containing 'NAK' if the notecard is not cached, or an empty list if no matches are found.

key llGetNotecardLine(string name, integer line)function

Asynchronously requests the line index line of the notecard name from the dataserver. Returns a key query handle for the dataserver event, which will return 'EOF' when reaching past the end of the notecard.

string llGetNotecardLineSync(string name, integer line)function

Synchronously reads the line index line of the notecard name from the region's cache, immediately returning its text without raising a dataserver event. Returns 'NAK' if not cached or 'EOF' if out of bounds.

key llGetNumberOfNotecardLines(string name)function

Asynchronously requests the total line count of the notecard name. Returns a key query handle for the dataserver event.

key llKeyCountKeyValue()function

Starts an asynchronous transaction requesting the total count of keys in the experience data store. Returns a key query handle for the dataserver event.

key llKeysKeyValue(integer first, integer count)function

Starts an asynchronous transaction to retrieve count keys from the experience data store starting at the zero-based index first. Returns a key query handle for the dataserver event. Fails with XP_ERROR_KEY_NOT_FOUND if out of bounds.

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.

key llReadKeyValue(string k)function

Starts an asynchronous transaction to read the value associated with key k in the experience. Returns a key query handle for the dataserver event. Fails with XP_ERROR_KEY_NOT_FOUND if the key does not exist.

key llUpdateKeyValue(string k, string v, integer checked, string original_value)function

Starts an asynchronous transaction to update the key k to value v inside the experience datastore. If checked is TRUE, the update fails with XP_ERROR_RETRY_UPDATE unless the existing value matches original_value.

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.

Data Storage

What do you want to do?

Reference