LlKeysKeyValue/ja

/ja

/LSL

KeysKeyValue/ja

llKeysKeyValue

要約

関数: key llKeysKeyValue( integer first, integer count );

?	関数ID
	遅延
	エネルギー

Start an asynchronous transaction to request a number of keys from the script's Experience.
that can be used to identify the corresponding dataserver/ja event to determine if this command succeeded or failed.を key で返します。

• integer	first	–	Zero-based index of the first key to retrieve
• integer	count	–	Number of keys to retriever

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 length of the returned list is limited to 4097 characters (the success flag "1" and 4096 characters). The order keys are returned is not guaranteed but is stable between subsequent calls as long as no keys are added or removed.
The error XP_ERROR_KEY_NOT_FOUND is returned if there index given is greater than or equal to the number of keys.

仕様

Dataserver

The dataserver callback parameters are:

• A key containing the handle returned from llKeysKeyValue
• 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 ] + keys),",")

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.
• list	keys	–	A list of keys (strings) used in the key-value store

警告

• 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.
• It is recommended that keys do not contain commas due to this function returning keys in CSV format.

サンプル

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)) );
            }
        } 
    }
}

注意点

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.

関連項目

関数

• llGetExperienceErrorMessage/ja
• llCreateKeyValue/ja
• llReadKeyValue/ja
• llUpdateKeyValue/ja
• llDeleteKeyValue/ja
• llDataSizeKeyValue/ja
• llKeyCountKeyValue/ja
• llKeysKeyValue/ja

特記事項

Search JIRA for related Issues

Signature
function key llKeysKeyValue( integer first, integer count );

この翻訳は 原文 と比べて古いですか？間違いがありますか？読みにくいですか？みんなで 修正 していきましょう！ (手順はこちら)

この項目はあなたにとって参考にならない項目ですか？もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。