View source for Category:LSL LinksetData/ja

{{LSL Header|ml=*}}

= はじめに =

リンクセットは、LSLスクリプトで使用可能なキー/値のペアとして、最大128KiBのデータを保存できます。このデータはリンクセット内のルートプリムに関連付けられ、転送、スクリプトのリセット、オブジェクトのコピーを行っても、メモリ使用量にはカウントされません。一度設定されると、それを削除する唯一の方法は、[[llLinksetDataReset/ja|llLinksetDataReset]]または[[llLinksetDataDelete/ja|llLinksetDataDelete]]関数を使用することです。スクリプトが[[llLinksetDataReset/ja|llLinksetDataReset]]、[[llLinksetDataWrite/ja|llLinksetDataWrite]]、または[[llLinksetDataCreate/ja|llLinksetDataCreate]]関数を使用してリンクセットデータを正常に変更すると、リンクセット内のすべてのスクリプトでリンクセットデータの変更を記述し、影響を受けたキー名を説明するlinkset_dataイベントが発生します。

リンクセットデータは、リンクセットの外部では見えません。スクリプトは、実行中のリンクセットのデータにのみアクセスできます。リンクセットデータはアバターには適用されません。

リンクセットデータを持つ2つのリンクセットをマージする場合、新しいルートのデータは保持され、シミュレータは古いルートからできるだけ多くのキー値ペアを新しいルートに移動しようとします。すべてのデータに十分なスペースがない場合、シミュレータは古いルートから一部のデータを破棄します。保存されるデータは任意のものである可能性があります。


= 関数 =
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataWrite/ja|llLinksetDataWrite]]
|func_desc=Creates or updates a key/value pair in the linksets datastore.
|p1_type=string|p1_name=name|p1_desc=key name for data to be stored.
|p2_type=string|p2_name=value|p2_desc=String data to be associated with this key.
|return_type=integer|return_text=indicating success or failure. {{mono|0}} is success, a positive number indicates failure.
|func_footer
|caveats=If value is an empty string, the key is deleted from the linkset data.
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataRead/ja|llLinksetDataRead]]
|func_desc=Reads the value associated with a key from the linkset's key-value datastore.
|p1_type=string|p1_name=name|p1_desc=key name for data to be read.
|return_type=string|return_text=associated with the key. If the key does not exist, an empty string is returned.
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataDelete/ja|llLinksetDataDelete]]
|func_desc=Removes a key value pair from the linkset's datastore.
|p1_type=string|p1_name=name|p1_desc=which is the key name for data to be read.
|return_type=|
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataDeleteFound/ja|llLinksetDataDeleteFound]]
|func_desc=finds and attempts to delete all keys in the data store that match pattern. 
|p1_type=string|p1_name=pattern|p1_desc=A regular expression describing which keys to delete.
|p2_type=string|p2_name=pass|p2_desc=Optional pass phrase to delete protected keys. 
|return_type=list|return_text=of the number of keys deleted or skipped.
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_id=|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataReset/ja|llLinksetDataReset]]
|func_desc=Erases all existing keys value pairs in the linkset's datastore.
|return_type=|
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataAvailable/ja|llLinksetDataAvailable]]
|func_desc=The number of bytes available in the linkset's datastore
|return_type=integer|return_text=with the number of bytes free in the datastore.
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataCountKeys/ja|llLinksetDataCountKeys]]
|func_desc=Returns the number of keys used in the datastore.
|return_type=integer|return_text=with the total number of keys in use.
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataCountFound/ja|llLinksetDataCountFound]]
|func_desc=Returns the number of keys in the linkset datastore that match the pattern supplied in the pattern.
|p1_type=string|p1_name=pattern|p1_desc=A regular expression describing which keys to return. 	
|return_type=integer|return_text=count of the keys in the datastore that match the supplied pattern.
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataListKeys/ja|llLinksetDataListKeys]]
|func_desc=Return a list of keys currently in use in the linkset data.
|p1_type=integer|p1_name=first|p1_desc=The (zero based) index of the first key to return. 
|p2_type=integer|p2_name=count|p2_desc=The maximum number of key names to return in the list.
|return_type=list|return_text=of keys stored in the linkset data.
|func_footer
|caveats=none
}}
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataFindKeys/ja|llLinksetDataFindKeys]]
|func_desc=Return a list of keys the linkset data which match the expression passed to the function.
|p1_type=string|p1_name=regex|p1_desc=A [https://en.wikipedia.org/wiki/Regular_expression regex expression] to search for.
|p2_type=integer|p2_name=first|p2_desc=The (zero based) index of the first key to return. 
|p3_type=integer|p3_name=count|p3_desc=The maximum number of key names to return in the list.
|return_type=list|return_text=of keys matching regex stored in the linkset data.
|func_footer
|caveats=none
}}

= Events =
{{LSL Function/Head
|func=[[linkset_data/ja|linkset_data]]
|p1_type=integer|p1_name=action|p1_desc=The action taken on the linkset datastore.  reset, update or delete.
|p2_type=string|p2_name=name|p2_desc=The name of key changed. Empty string for reset.
|p3_type=string|p3_name=value|p3_desc=The value associated with the key. Empty string for reset or delete.
|event_desc=Triggered in all scripts in a linkset when the Linkset key/value database is modified.
}}