Second Life Wiki - User contributions [en]

LlKeyCountKeyValue

2015-02-07T13:43:29Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|d2_type=integer|d2_name=pairs|d2_desc=number of keys-value pairs in the key-value store}}
|func=llKeyCountKeyValue
|func_desc=Start an asynchronous transaction to request the number of keys in the system.
|func_footnote
|return_type=key|return_subtype=handle
|return_text=that can be used to identify the corresponding [[dataserver]] event to determine if this command succeeded or failed and the results.
|also_functions=
*[[llGetExperienceErrorMessage]]
*[[llCreateKeyValue]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">key trans;
default
{
state_entry()
{
trans = llKeyCountKeyValue();
}

dataserver(key t, string value)
{
if (t == trans)
{
// our llKeyCountKeyValue transaction is done
list result = llCSV2List(value);
if (llList2Integer(result, 0) == 1)
{
// data size retrieved
llSay(0, "Keys in use: "+llList2String(result, 1));
}
else
{
// key count failed
llSay(0, "Key-value failed to count keys: " + llList2String(result, 1) );
}
}
}
}</source>
|cat1=Experience
|cat2=Dataserver
|cat3=Experience/Data
}}

LlDataSizeKeyValue

2015-02-07T13:42:45Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|d2_type=integer|d2_name=used|d2_desc=Number of bytes used|d3_type=integer|d3_name=quota|d3_desc=Number of bytes the key-store can utilize}}
|func=llDataSizeKeyValue
|func_desc=Start an asynchronous transaction to request the used and total amount of data allocated for the experience.
|func_footnote=
|return_type=key|return_subtype=handle
|return_text=that can be used to identify the corresponding [[dataserver]] event to determine if this command succeeded or failed and the results.
|also_functions=
*[[llGetExperienceErrorMessage]]
*[[llCreateKeyValue]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">key trans;

default
{
state_entry()
{
trans = llDataSizeKeyValue();
}

dataserver( key _t, string _value )
{
if ( _t == trans )
{
// our llDataSizeKeyValue transaction is done
list result = llCSV2List( _value );
if ( llList2Integer( result, 0 ) == 1 )
{
// data size retrieved
llSay( 0, "Space in use: " + llList2String( result, 1 ) );
llSay( 0, "Total space: " + llList2String( result, 2 ) );
}
else
{
// data size check failed
llSay( 0, "Key-value failed to check size: " + llList2String( result, 1 ) );
}
}
}
}
</source>
|cat1=Experience
|cat2=Experience/Data
|cat3=Dataserver
}}

LlDeleteKeyValue

2015-02-07T13:42:05Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|k|value=value|d2_type=string|d2_name=value}}
|func=llDeleteKeyValue
|func_desc=Start an asynchronous transaction to delete a key-value pair associated with the given experience key with the given key.
|func_footnote
|return_type=key|return_subtype=handle
|return_text=that can be used to identify the corresponding [[dataserver]] event to determine if this command succeeded or failed and the results.
|p1_type=string|p1_name=k|p1_desc=The key for the key-value pair
|also_functions=
*[[llGetExperienceErrorMessage]]
*[[llCreateKeyValue]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">key trans;
default
{
state_entry()
{
trans = llDeleteKeyValue("FOO");
}

dataserver(key t, string value)
{
if (t == trans)
{
// our llDeleteKeyValue transaction is done
list result = llCSV2List(value);
if (llList2Integer(result, 0) == 1)
{
// the key-value pair was successfully deleted
llSay(0, "New key-value pair was deleted");
}
else
{
// the key-value pair was not deleted
llSay(0, "Key-value failed to delete: " + llList2String(result, 1) );
}
}
}
}</source>
|cat1=Experience
|cat2=Experience/Data
|cat3=Dataserver
}}

LlReadKeyValue

2015-02-07T13:36:45Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|k|value=value|d2_type=string|d2_name=value}}
|func=llReadKeyValue
|func_desc=Start an asynchronous transaction to read the value associated with the specified key and the specified experience.
|func_footnote
|return_type=key|return_subtype=handle
|return_text=that can be used to identify the corresponding [[dataserver]] event to determine if this command succeeded or failed and the results.
|p1_type=string|p1_name=k
|also_functions=
*[[llGetExperienceErrorMessage]]
*[[llCreateKeyValue]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">key trans;
default
{
state_entry()
{
trans = llReadKeyValue("FOO");
}
dataserver(key t, string value)
{
if (t == trans)
{
// our llReadKeyValue transaction is done
if (llGetSubString(value, 0, 0) == "1")
{
// the key-value pair was successfully read
llSay(0, "New key-value pair value: " + llGetSubString(value, 2, -1));
}
else
{
// the key-value pair failed to read
integer error = (integer)llGetSubString(value, 2, -1);
llSay(0, "Key-value failed to read: " + llGetExperienceErrorMessage(error));
}
}
}
}</source>
|cat1=Experience
|cat2=Experience/Data
|cat3=Dataserver
}}

LlKeysKeyValue

2015-02-07T13:35:44Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|dl_name=keys
|dl_desc=A list of keys ([[String|strings]]) used in the key-value store
|dl_hover=A list of keys (strings) used in the key-value store}}
|func=llKeysKeyValue
|func_desc=Start an asynchronous transaction to request a number of keys.
|func_footnote=
This function will attempt to retrieve the number of keys requested but may return less if there are not enough to fulfill the full amount requested or if the list is too large. The order keys are returned is not guaranteed but is stable between subsequent calls as long as no keys are added or removed.<br/>
The error [[XP_ERROR_KEY_NOT_FOUND]] is returned if there index given is greater than or equal to the number of keys.
|return_type=key|return_subtype=handle
|return_text=that can be used to identify the corresponding [[dataserver]] event to determine if this command succeeded or failed.
|p1_type=integer|p1_name=first|p1_desc=Zero-based index of the first key to retrieve
|p2_type=integer|p2_name=count|p2_desc=Number of keys to retriever
|also_functions=
*[[llGetExperienceErrorMessage]]
*[[llCreateKeyValue]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">key trans;
default
{
state_entry()
{
// retrieve the first 10 keys
trans = llKeysKeyValue(0, 10);
}

dataserver(key t, string value)
{
if (t == trans)
{
// our llKeysKeyValue transaction is done
list result = llCSV2List(value);
if (llList2Integer(result, 0) == 1)
{
llSay(0, "Keys retrieved: "+(string)llGetSubString(value, 2, -1));
}
else if (llList2Integer(result, 1) == XP_ERROR_KEY_NOT_FOUND)
{
// no more keys
llSay(0, "No more keys" );
}
else
{
// keys request failed
llSay(0, "Key-value failed to request keys: " + llGetExperienceErrorMessage(llList2Integer(result, 1)) );
}
}
}
}</source>}}

LlGetExperienceErrorMessage

2015-02-07T13:34:07Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|func=llGetExperienceErrorMessage
|func_desc=Returns a text description of a particular Experience LSL error constant.
|return_type=string
|return_text=describing the error code passed or the string corresponding to {{LSLP|error}}. Returns [[XP_ERROR_UNKNOWN_ERROR]] if the {{LSLP|error}} is not a valid error code.
|p1_type=integer|p1_subtype=experience_error|p1_name=error|p1_desc=The error code constant to translate.
|constants={{LSL Constants/Experience Tools Errors}}
|also_functions=
*[[llCreateKeyValue]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">default
{
state_entry()
{
llOwnerSay(llGetExperienceErrorMessage(XP_ERROR_NONE));
}
}</source>
|cat1=Experience
}}

LlCreateKeyValue

2015-02-07T13:32:32Z

Quartz Mole: fixed broken lsl formatting

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|k|v|dataserver|value=value|d2_type=string|d2_name=value}}
|func=llCreateKeyValue
|func_desc=Start an asynchronous transaction to create a key-value pair associated with the given experience key using the given key and value.
|func_footnote=If the key already exists the [[dataserver]] will return a failure along with the error [[XP_ERROR_STORAGE_EXCEPTION]].
|return_type=key|return_subtype=handle
|return_text=that can be used to identify the corresponding [[dataserver]] event to determine if this command succeeded or failed.
|p1_type=string|p1_name=k
|p2_type=string|p2_name=v
|also_functions=
*[[llGetExperienceErrorMessage]]
*[[llReadKeyValue]]
*[[llUpdateKeyValue]]
*[[llDeleteKeyValue]]
*[[llDataSizeKeyValue]]
*[[llKeyCountKeyValue]]
*[[llKeysKeyValue]]
|examples=<source lang="lsl2">key trans;
default
{
touch_start(integer total_number)
{
trans = llCreateKeyValue("FOO", "BAR");
}

dataserver(key t, string value)
{
if (t == trans)
{
// our llCreateKeyValue transaction is done
integer result = (integer)llGetSubString(value, 0, 0);
if (result == 1)
{
// the key-value pair was successfully created
llSay(0, "New key-value pair was created");
}
else
{
// the key-value pair was not created
integer error = (integer)(llGetSubString(value, 2, -1));
llSay(0, "Key-value failed to create: " + llGetExperienceErrorMessage(error));
}
}
}
}</source>
|cat1=Experience
|cat2=Experience/Data
|cat3=Dataserver
}}