llKeyCountKeyValue/ja
< LlKeyCountKeyValue
Jump to navigation
Jump to search
Revision as of 20:25, 7 October 2023 by Misaki Vanilla (talk | contribs) (copy from english(Todo: need translate to japanese))
LSL ポータル | 関数 | イベント | 型 | 演算子 | 定数 | 実行制御 | スクリプトライブラリ | カテゴリ別スクリプトライブラリ | チュートリアル |
Summary
Function: key llKeyCountKeyValue( );
Start an asynchronous transaction to request the number of keys with the script's 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.
Specification
Dataserver
The dataserver callback parameters are:
- A key containing the handle returned from llKeyCountKeyValue
- A string containing a comma-delimited list (cdl).
llDumpList2String([ integer success ] + components);
- components vary depending upon success or failure of request.
- Failure:
cdl = llDumpList2String([ 0, integer error],",")
- Success:
cdl = llDumpList2String([ 1, integer pairs ],",")
String Components
• integer | success | – | A boolean specifying if the transaction succeeded (1) or not (0). | |
• integer | error | – | An XP_ERROR_* flag that describes why the operation failed. | |
• integer | pairs | – | number of keys-value pairs in the key-value store |
Caveats
- If you recompile a script that was previously associated with an Experience but do so with a client that lacks the ability to compile scripts into an experience the script will lose the associated Experience.
Examples
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) );
}
}
}
}
Notes
Compiling
For a script to be associated with an Experience...
- It must be compiled with a client that is Experience aware,
- The "Use Experience" checkbox must be checked,
- And one of the users Experience keys selected.
重要 Not all TPVs have this functionality. |
See Also
Deep Notes
Categories:
- Pages using deprecated source tags
- Experience Tools
- LSL Key/handle/ja
- LSL Integer/boolean/ja
- LSL Integer/experience error/ja
- LSL Dataserver/ja
- Articles in need of haiku/ja
- LSL Functions/ja
- LSL Functions/Returns a key/ja
- LSL Functions/Returns a key/handle/ja
- LSL Keywords/All/ja
- LSL Functions/Without IDs/ja
- LSL Experience/ja
- LSL Experience/Data/ja