LlCreateKeyValue/ja - Revision history

Misaki Vanilla at 20:59, 22 November 2023

2023-11-22T20:59:49Z

← Older revision		Revision as of 13:59, 22 November 2023
Line 1:		Line 1:
	[[Category:Experience Tools/ja]]		[[Category:Experience Tools/ja]]
	{{LSL_Function/ja		{{LSL_Function/ja
	\|inject-2={{LSL Function/KeyValue\|k\|v\|dataserver\|value=value\|d2_type=string\|d2_name=value}}{{LSL Function/Experience\|true}}		\|inject-2={{LSL Function/KeyValue/ja\|k\|v\|dataserver\|value=value\|d2_type=string\|d2_name=value}}{{LSL Function/Experience/ja\|true}}
	\|func=llCreateKeyValue		\|func=llCreateKeyValue
	\|func_desc=~~Start an asynchronous transaction to create a key-value pair associated with the script's~~ {{~~LSLGC~~\|~~Experience~~}} ~~using the given key (~~{{LSLPT\|k}}~~) and value (~~{{~~LSLPT~~\|v}}).		\|func_desc=与えられたキー（{{LSLPT\|k}}）と値（{{LSLPT\|v}}）を使用して、スクリプトの{{LSLGC\|Experience}}に関連付けられた非同期トランザクションを開始してキー値ペアを作成します。
	\|func_footnote=~~If the key already exists the~~ [[dataserver]] ~~will return a failure along with the error~~ [[XP_ERROR_STORAGE_EXCEPTION]].<br/>		\|func_footnote=すでにキーが存在する場合、[[dataserver]]は失敗とエラー[[XP_ERROR_STORAGE_EXCEPTION]]とともに返ります。<br/>
	<br/>		<br/>
	~~As of Jan 1, 2016 maximum bytes is 1011 for key and 4095 for value for both LSO and Mono scripts.~~		2016年1月1日現在、LSOおよびMonoスクリプトのキーおよび値の最大バイト数はそれぞれ1011および4095です。
	\|return_type=key\|return_subtype=handle		\|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.~~		\|return_text=これにより、このコマンドが成功したか失敗したかを判断するために対応する[[dataserver]]イベントを識別するために使用できるハンドルが返されます。
	\|p1_type=string\|p1_name=k		\|p1_type=string\|p1_name=k
	\|p2_type=string\|p2_name=v		\|p2_type=string\|p2_name=v
Line 52:		Line 52:
	\|cat2=Experience/Data		\|cat2=Experience/Data
	\|cat3=Dataserver		\|cat3=Dataserver
	\|caveats=* ~~It is recommended that keys do not contain commas due to~~ [[llKeysKeyValue]] ~~returning keys in CSV format.~~		\|caveats=* [[llKeysKeyValue]]がキーをCSV形式で返すため、キーにはカンマを含めないことが推奨されています。
	\|* ~~If this function returns an~~ [[XP_ERROR_STORAGE_EXCEPTION]]~~, subsequent attempts to create the same KVP key may also fail, even if it appears that no key has been created. For that reason, it may be preferable to use~~ [[llUpdateKeyValue]]~~, which will overwrite any existing value or will create a new KVP key if none exists with that name.~~		\|* この関数が[[XP_ERROR_STORAGE_EXCEPTION]]を返す場合、同じKVPキーを作成しようとする後続の試みも失敗する可能性があります。これにより、キーが作成されていないかのように見えても、[[llUpdateKeyValue]]を使用することが好ましい場合があります。[[llUpdateKeyValue]]は既存の値を上書きするか、その名前のKVPキーが存在しない場合は新しいKVPキーを作成します。
	\|haiku={{Haiku\|Clear sky with bright sun\|Wonderful key created\|from an old value}}		\|haiku={{Haiku\|Clear sky with bright sun\|Wonderful key created\|from an old value}}
	}}		}}

Misaki Vanilla at 20:27, 2 November 2023

2023-11-02T20:27:57Z

← Older revision		Revision as of 13:27, 2 November 2023
Line 1:		Line 1:
	[[Category:Experience Tools/ja]]		[[Category:Experience Tools/ja]]
	{{LSL_Function		{{LSL_Function/ja
	\|inject-2={{LSL Function/KeyValue\|k\|v\|dataserver\|value=value\|d2_type=string\|d2_name=value}}{{LSL Function/Experience\|true}}		\|inject-2={{LSL Function/KeyValue\|k\|v\|dataserver\|value=value\|d2_type=string\|d2_name=value}}{{LSL Function/Experience\|true}}
	\|func=llCreateKeyValue		\|func=llCreateKeyValue
Line 49:		Line 49:
	}		}
	}</syntaxhighlight>		}</syntaxhighlight>
	\|cat1=Experience~~/ja~~		\|cat1=Experience
	\|cat2=Experience/Data~~/ja~~		\|cat2=Experience/Data
	\|cat3=Dataserver~~/ja~~		\|cat3=Dataserver
	\|caveats=* It is recommended that keys do not contain commas due to [[llKeysKeyValue]] returning keys in CSV format.		\|caveats=* It is recommended that keys do not contain commas due to [[llKeysKeyValue]] returning keys in CSV format.
	\|* If this function returns an [[XP_ERROR_STORAGE_EXCEPTION]], subsequent attempts to create the same KVP key may also fail, even if it appears that no key has been created. For that reason, it may be preferable to use [[llUpdateKeyValue]], which will overwrite any existing value or will create a new KVP key if none exists with that name.		\|* If this function returns an [[XP_ERROR_STORAGE_EXCEPTION]], subsequent attempts to create the same KVP key may also fail, even if it appears that no key has been created. For that reason, it may be preferable to use [[llUpdateKeyValue]], which will overwrite any existing value or will create a new KVP key if none exists with that name.
	\|haiku={{Haiku\|Clear sky with bright sun\|Wonderful key created\|from an old value}}		\|haiku={{Haiku\|Clear sky with bright sun\|Wonderful key created\|from an old value}}
	}}		}}

Misaki Vanilla at 10:52, 8 October 2023

2023-10-08T10:52:40Z

← Older revision		Revision as of 03:52, 8 October 2023
Line 1:		Line 1:
	[[Category:Experience Tools]]		[[Category:Experience Tools/ja]]
	{{LSL_Function		{{LSL_Function
	\|inject-2={{LSL Function/KeyValue\|k\|v\|dataserver\|value=value\|d2_type=string\|d2_name=value}}{{LSL Function/Experience\|true}}		\|inject-2={{LSL Function/KeyValue\|k\|v\|dataserver\|value=value\|d2_type=string\|d2_name=value}}{{LSL Function/Experience\|true}}
Line 12:		Line 12:
	\|p2_type=string\|p2_name=v		\|p2_type=string\|p2_name=v
	\|also_functions=		\|also_functions=
	*[[llGetExperienceErrorMessage]]		*[[llGetExperienceErrorMessage/ja]]
	*[[llReadKeyValue]]		*[[llReadKeyValue/ja]]
	*[[llUpdateKeyValue]]		*[[llUpdateKeyValue/ja]]
	*[[llDeleteKeyValue]]		*[[llDeleteKeyValue/ja]]
	*[[llDataSizeKeyValue]]		*[[llDataSizeKeyValue/ja]]
	*[[llKeyCountKeyValue]]		*[[llKeyCountKeyValue/ja]]
	*[[llKeysKeyValue]]		*[[llKeysKeyValue/ja]]
	\|examples=<syntaxhighlight lang="lsl2">key trans;		\|examples=<syntaxhighlight lang="lsl2">key trans;
	default		default
Line 49:		Line 49:
	}		}
	}</syntaxhighlight>		}</syntaxhighlight>
	\|cat1=Experience		\|cat1=Experience/ja
	\|cat2=Experience/Data		\|cat2=Experience/Data/ja
	\|cat3=Dataserver		\|cat3=Dataserver/ja
	\|caveats=* It is recommended that keys do not contain commas due to [[llKeysKeyValue]] returning keys in CSV format.		\|caveats=* It is recommended that keys do not contain commas due to [[llKeysKeyValue]] returning keys in CSV format.
	\|* If this function returns an [[XP_ERROR_STORAGE_EXCEPTION]], subsequent attempts to create the same KVP key may also fail, even if it appears that no key has been created. For that reason, it may be preferable to use [[llUpdateKeyValue]], which will overwrite any existing value or will create a new KVP key if none exists with that name.		\|* If this function returns an [[XP_ERROR_STORAGE_EXCEPTION]], subsequent attempts to create the same KVP key may also fail, even if it appears that no key has been created. For that reason, it may be preferable to use [[llUpdateKeyValue]], which will overwrite any existing value or will create a new KVP key if none exists with that name.
	\|haiku={{Haiku\|Clear sky with bright sun\|Wonderful key created\|from an old value}}		\|haiku={{Haiku\|Clear sky with bright sun\|Wonderful key created\|from an old value}}
	}}		}}

Misaki Vanilla: copy from english(Todo: need translate to japanese)

2023-10-08T02:57:54Z

copy from english(Todo: need translate to japanese)

New page

[[Category:Experience Tools]]
{{LSL_Function
|inject-2={{LSL Function/KeyValue|k|v|dataserver|value=value|d2_type=string|d2_name=value}}{{LSL Function/Experience|true}}
|func=llCreateKeyValue
|func_desc=Start an asynchronous transaction to create a key-value pair associated with the script's {{LSLGC|Experience}} using the given key ({{LSLPT|k}}) and value ({{LSLPT|v}}).
|func_footnote=If the key already exists the [[dataserver]] will return a failure along with the error [[XP_ERROR_STORAGE_EXCEPTION]].<br/>
<br/>
As of Jan 1, 2016 maximum bytes is 1011 for key and 4095 for value for both LSO and Mono scripts.
|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=<syntaxhighlight 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));
}
}
}
}</syntaxhighlight>
|cat1=Experience
|cat2=Experience/Data
|cat3=Dataserver
|caveats=* It is recommended that keys do not contain commas due to [[llKeysKeyValue]] returning keys in CSV format.
|* If this function returns an [[XP_ERROR_STORAGE_EXCEPTION]], subsequent attempts to create the same KVP key may also fail, even if it appears that no key has been created. For that reason, it may be preferable to use [[llUpdateKeyValue]], which will overwrite any existing value or will create a new KVP key if none exists with that name.
|haiku={{Haiku|Clear sky with bright sun|Wonderful key created|from an old value}}
}}