Dataserver

Request data delivered through the dataserver event.

Feature: Data Storage

What do you want to do?

key llRequestAgentData(key id, integer data)Asynchronously requests the specified data category (DATA_*) about the agent id. Triggers a dataserver event with the results and returns a key query handle.key llGetNotecardLine(string name, integer line)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.key llRequestSimulatorData(string region, integer data)Asynchronously requests data (using a DATA_SIM_* constant) about the region. Triggers a dataserver event and returns a key query handle.

Reference

Find topic entries

17 topic entries

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

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

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

• 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 llRequestAgentData(key id, integer data)function

  Asynchronously requests the specified data category (DATA_*) about the agent id. Triggers a dataserver event with the results and returns a key query handle.

• key llRequestDisplayName(key id)function

  Asynchronously requests the display name of the agent specified by id, triggering a dataserver event with the results. The agent does not need to be online or in the region. Returns a key query handle.

• key llRequestInventoryData(string item)function

  Asynchronously requests data for the named inventory item, triggering a dataserver event. Currently, only landmark items are supported (which return local region coordinates). Returns a key query handle.

• key llRequestSimulatorData(string region, integer data)function

  Asynchronously requests data (using a DATA_SIM_* constant) about the region. Triggers a dataserver event and returns a key query handle.

• key llRequestUserKey(string username)function

  Asynchronously requests the Agent ID key (UUID) for the agent specified by their current or historical username, returning NULL_KEY if not found. Returns a key query handle for the dataserver event.

• key llRequestUsername(key id)function

  Asynchronously requests the unique single-word username of the agent identified by id, triggering a dataserver event. The agent does not need to be online or in the region. Returns a key query handle.

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

• dataserver(key queryid, string data)event

  Triggered when requested data is returned to the script (e.g., from llRequestAgentData, llRequestInventoryData, or llGetNotecardLine).