查看“LlCreateKeyValue”的源代码

{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}}


{{函数详情
|函数名 = Function: key llCreateKeyValue( string k, string v );
|参数= 参数：• string	k	–	‎键值对的键
• string	v	–	‎键值对的值。最大 2047 个字符，如果使用 Mono，则最多为 4095 个字符。‎
|返回值= 返回值：返回一个句柄(一个键) ，该句柄可用于标识相应的数据服务器事件，以确定该命令是成功还是失败。

|注意事项=
如果你重新编译了一个脚本，这个脚本以前与一个体验相关，但是客户端缺乏将脚本编译成一个体验的能力，那么这个脚本就会失去相关的体验。 出于这个原因，最好使用 llupdatekeyvalue，它将覆盖任何现有的值，或者在没有该名称的情况下创建一个新的 kvp 键。

|示例=
<pre>
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));
            }
        }
    } 
}
<pre>

|相关函数=
[[llGetExperienceErrorMessage]]
[[llReadKeyValue]]
[[llUpdateKeyValue]]
[[llDeleteKeyValue]]
[[llDataSizeKeyValue]]
[[llKeyCountKeyValue]]
[[llKeysKeyValue]]

}}