Difference between revisions of "LlDataSizeKeyValue"
Jump to navigation
Jump to search
(Created page with "Category:Experience Tools {{LSL_Function |func=llDataSizeKeyValue |func_desc=Start an asynchronous transaction to request the used and total amount of data allocated for the …") |
m |
||
| Line 4: | Line 4: | ||
|func_desc=Start an asynchronous transaction to request the used and total amount of data allocated for the experience. | |func_desc=Start an asynchronous transaction to request the used and total amount of data allocated for the experience. | ||
|func_footnote= | |func_footnote= | ||
The dataserver callback parameters are: | The [[dataserver]] callback parameters are: | ||
* A key containing the | * A key containing the {{LSLGC|Key/handle|handle}} returned from llDataSizeKeyValue | ||
* A string containing a comma-delimited list. The first item is a boolean specifying if the transaction succeeded (1) or not (0). The second item is the amount in use, and the third value is the total. All sizes are in bytes. | * A string containing a comma-delimited list. The first item is a boolean specifying if the transaction succeeded (1) or not (0). The second item is the amount in use, and the third value is the total. All sizes are in bytes. | ||
|return_type=key | |return_type=key|return_subtype=handle | ||
|return_text= | |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= | |also_functions= | ||
*[[llGetExperienceErrorMessage]] | *[[llGetExperienceErrorMessage]] | ||
| Line 45: | Line 45: | ||
} | } | ||
} | } | ||
}</lsl>}} | }</lsl> | ||
|cat1=Experience | |||
|cat2=Experience/Data | |||
|cat3=Dataserver | |||
}} | |||
Revision as of 10:36, 9 July 2014
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: key llDataSizeKeyValue( );
Start an asynchronous transaction to request the used and total amount of data allocated for the experience.
Returns a handle (a key) that can be used to identify the corresponding dataserver event to determine if this command succeeded or failed and the results.
The dataserver callback parameters are:
- A key containing the handle returned from llDataSizeKeyValue
- A string containing a comma-delimited list. The first item is a boolean specifying if the transaction succeeded (1) or not (0). The second item is the amount in use, and the third value is the total. All sizes are in bytes.
Caveats
Examples
<lsl>key trans; default {
state_entry()
{
trans = llDataSizeKeyValue("FOO");
}
}
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) );
}
}
}</lsl>