Difference between revisions of "Category:LSL LinksetData/ja"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 13: Line 13:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataWrite/ja]]
|func=[[llLinksetDataWrite/ja|llLinksetDataWrite]]
|func_desc=Creates or updates a key/value pair in the linksets datastore.
|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.
|p1_type=string|p1_name=name|p1_desc=key name for data to be stored.
Line 23: Line 23:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataRead/ja]]
|func=[[llLinksetDataRead/ja|llLinksetDataRead]]
|func_desc=Reads the value associated with a key from the linkset's key-value datastore.
|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.
|p1_type=string|p1_name=name|p1_desc=key name for data to be read.
Line 32: Line 32:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataDelete/ja]]
|func=[[llLinksetDataDelete/ja|llLinksetDataDelete]]
|func_desc=Removes a key value pair from the linkset's datastore.
|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.
|p1_type=string|p1_name=name|p1_desc=which is the key name for data to be read.
Line 41: Line 41:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataDeleteFound/ja]]
|func=[[llLinksetDataDeleteFound/ja|llLinksetDataDeleteFound]]
|func_desc=finds and attempts to delete all keys in the data store that match pattern.  
|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.
|p1_type=string|p1_name=pattern|p1_desc=A regular expression describing which keys to delete.
Line 51: Line 51:
{{LSL Function/Head
{{LSL Function/Head
|func_id=|func_sleep=0.0|func_energy=10.0
|func_id=|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataReset/ja]]
|func=[[llLinksetDataReset/ja|llLinksetDataReset]]
|func_desc=Erases all existing keys value pairs in the linkset's datastore.
|func_desc=Erases all existing keys value pairs in the linkset's datastore.
|return_type=|
|return_type=|
Line 59: Line 59:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataAvailable/ja]]
|func=[[llLinksetDataAvailable/ja|llLinksetDataAvailable]]
|func_desc=The number of bytes available in the linkset's datastore
|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.
|return_type=integer|return_text=with the number of bytes free in the datastore.
Line 67: Line 67:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataCountKeys/ja]]
|func=[[llLinksetDataCountKeys/ja|llLinksetDataCountKeys]]
|func_desc=Returns the number of keys used in the datastore.
|func_desc=Returns the number of keys used in the datastore.
|return_type=integer|return_text=with the total number of keys in use.
|return_type=integer|return_text=with the total number of keys in use.
Line 75: Line 75:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataCountFound/ja]]
|func=[[llLinksetDataCountFound/ja|llLinksetDataCountFound]]
|func_desc=Returns the number of keys in the linkset datastore that match the pattern supplied in the pattern.
|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.
|p1_type=string|p1_name=pattern|p1_desc=A regular expression describing which keys to return.
Line 84: Line 84:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataListKeys/ja]]
|func=[[llLinksetDataListKeys/ja|llLinksetDataListKeys]]
|func_desc=Return a list of keys currently in use in the linkset data.
|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.  
|p1_type=integer|p1_name=first|p1_desc=The (zero based) index of the first key to return.  
Line 94: Line 94:
{{LSL Function/Head
{{LSL Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataFindKeys/ja]]
|func=[[llLinksetDataFindKeys/ja|llLinksetDataFindKeys]]
|func_desc=Return a list of keys the linkset data which match the expression passed to the function.
|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.
|p1_type=string|p1_name=regex|p1_desc=A [https://en.wikipedia.org/wiki/Regular_expression regex expression] to search for.
Line 106: Line 106:
= Events =
= Events =
{{LSL Function/Head
{{LSL Function/Head
|func=[[linkset_data/ja]]
|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.
|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.
|p2_type=string|p2_name=name|p2_desc=The name of key changed. Empty string for reset.

Revision as of 16:47, 25 September 2023

はじめに

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

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

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


関数

llLinksetDataWrite

Function: integer llLinksetDataWrite( string name, string value );

Creates or updates a key/value pair in the linksets datastore.
Returns an integer indicating success or failure. 0 is success, a positive number indicates failure.

• string name – key name for data to be stored.
• string value – String data to be associated with this key.
Caveats

If value is an empty string, the key is deleted from the linkset data.

All Issues ~ Search JIRA for related Bugs

llLinksetDataRead

Function: string llLinksetDataRead( string name );

Reads the value associated with a key from the linkset's key-value datastore.
Returns a string associated with the key. If the key does not exist, an empty string is returned.

• string name – key name for data to be stored.key name for data to be read.

llLinksetDataDelete

Function: llLinksetDataDelete( string name );

Removes a key value pair from the linkset's datastore.

• string name – key name for data to be stored.key name for data to be read.which is the key name for data to be read.

llLinksetDataDeleteFound

Function: list llLinksetDataDeleteFound( string pattern, string pass );

finds and attempts to delete all keys in the data store that match pattern.
Returns a list of the number of keys deleted or skipped.

• string pattern – A regular expression describing which keys to delete.
• string pass – Optional pass phrase to delete protected keys.

llLinksetDataReset

Function: llLinksetDataReset( );

Erases all existing keys value pairs in the linkset's datastore.

llLinksetDataAvailable

Function: integer llLinksetDataAvailable( );

The number of bytes available in the linkset's datastore
Returns an integer with the number of bytes free in the datastore.

llLinksetDataCountKeys

Function: integer llLinksetDataCountKeys( );

Returns the number of keys used in the datastore.
Returns an integer with the total number of keys in use.

llLinksetDataCountFound

Function: integer llLinksetDataCountFound( string pattern );

Returns the number of keys in the linkset datastore that match the pattern supplied in the pattern.
Returns an integer count of the keys in the datastore that match the supplied pattern.

• string pattern – A regular expression describing which keys to delete.A regular expression describing which keys to return.

llLinksetDataListKeys

Function: list llLinksetDataListKeys( integer first, integer count );

Return a list of keys currently in use in the linkset data.
Returns a list of keys stored in the linkset data.

• integer first – The (zero based) index of the first key to return.
• integer count – The maximum number of key names to return in the list.

llLinksetDataFindKeys

Function: list llLinksetDataFindKeys( string regex, integer first, integer count );

Return a list of keys the linkset data which match the expression passed to the function.
Returns a list of keys matching regex stored in the linkset data.

• string regex – A regex expression to search for.
• integer first – The (zero based) index of the first key to return.The (zero based) index of the first key to return.
• integer count – The maximum number of key names to return in the list.The maximum number of key names to return in the list.

Events

linkset_data

Function: linkset_data( integer action, string name, string value );
• integer action – The action taken on the linkset datastore. reset, update or delete.
• string name – key name for data to be stored.key name for data to be read.which is the key name for data to be read.The name of key changed. Empty string for reset.
• string value – String data to be associated with this key.The value associated with the key. Empty string for reset or delete.
All Issues ~ Search JIRA for related Bugs
Retrieved from "https://wiki.secondlife.com/w/index.php?title=Category:LSL_LinksetData/ja&oldid=1214642"