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

From Second Life Wiki
Jump to navigation Jump to search
m
m
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{LSL Header|ml=*}}
{{LSL Header/ja|ml=*}}


= はじめに =
= はじめに =


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


リンクセットデータは、リンクセットの外部では見えません。スクリプトは、実行中のリンクセットのデータにのみアクセスできます。リンクセットデータはアバターには適用されません。
リンクセットデータは、リンクセットの外部では見えません。スクリプトは、実行中のリンクセットのデータにのみアクセスできます。リンクセットデータはアバターには適用されません。
Line 14: Line 14:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataWrite/ja|llLinksetDataWrite]]
|func=[[llLinksetDataWrite/ja|llLinksetDataWrite]]
|func_desc=Creates or updates a key/value pair in the linksets datastore.
|func_desc=リンクセットデータストア内にキー/値のペアを作成または更新します。
|p1_type=string|p1_name=name|p1_desc=key name for data to be stored.
|p1_type=string|p1_name=name1|p1_desc=データを格納するためのキー名。
|p2_type=string|p2_name=value|p2_desc=String data to be associated with this key.
|p2_type=string|p2_name=value1|p2_desc=このキーに関連付ける文字列データ。
|return_type=integer|return_text=indicating success or failure. {{mono|0}} is success, a positive number indicates failure.
|return_type=integer|return_text=成功または失敗を示すものです。{{mono|0}}は成功を示し、正の数は失敗を示します。
|func_footer
|func_footer
|caveats=If value is an empty string, the key is deleted from the linkset data.
|caveats='''value'''が空の文字列の場合、キーはリンクセットデータから削除されます。
}}
}}
{{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|llLinksetDataRead]]
|func=[[llLinksetDataRead/ja|llLinksetDataRead]]
|func_desc=Reads the value associated with a key from the linkset's key-value datastore.
|func_desc=リンクセットのキー値データストアからキーに関連付けられた値を読み取ります。
|p1_type=string|p1_name=name|p1_desc=key name for data to be read.
|p1_type=string|p1_name=name2|p1_desc=読み取るデータのキー名。
|return_type=string|return_text=associated with the key. If the key does not exist, an empty string is returned.
|return_type=string|return_text=キーに関連付けられたもの。キーが存在しない場合、空の文字列が返されます。
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 33: Line 33:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataDelete/ja|llLinksetDataDelete]]
|func=[[llLinksetDataDelete/ja|llLinksetDataDelete]]
|func_desc=Removes a key value pair from the linkset's datastore.
|func_desc=リンクセットのデータストアからキーと値のペアを削除します。
|p1_type=string|p1_name=name|p1_desc=which is the key name for data to be read.
|p1_type=string|p1_name=name3|p1_desc=読み取るデータのキー名
|return_type=|
|return_type=|
|func_footer
|func_footer
Line 42: Line 42:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataDeleteFound/ja|llLinksetDataDeleteFound]]
|func=[[llLinksetDataDeleteFound/ja|llLinksetDataDeleteFound]]
|func_desc=finds and attempts to delete all keys in the data store that match pattern.
|func_desc=データストア内でパターンに一致するすべてのキーを検索し、削除しようとします。
|p1_type=string|p1_name=pattern|p1_desc=A regular expression describing which keys to delete.
|p1_type=string|p1_name=pattern4|p1_desc=削除するキーを記述する正規表現。
|p2_type=string|p2_name=pass|p2_desc=Optional pass phrase to delete protected keys.
|p2_type=string|p2_name=pass4|p2_desc=保護されたキーを削除するためのオプションのパスフレーズ。
|return_type=list|return_text=of the number of keys deleted or skipped.
|return_type=list|return_text=削除またはスキップされたキーの数。
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 52: Line 52:
|func_id=|func_sleep=0.0|func_energy=10.0
|func_id=|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataReset/ja|llLinksetDataReset]]
|func=[[llLinksetDataReset/ja|llLinksetDataReset]]
|func_desc=Erases all existing keys value pairs in the linkset's datastore.
|func_desc=リンクセットのデータストア内のすべての既存のキーと値のペアを削除します。
|return_type=|
|return_type=|
|func_footer
|func_footer
Line 60: Line 60:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataAvailable/ja|llLinksetDataAvailable]]
|func=[[llLinksetDataAvailable/ja|llLinksetDataAvailable]]
|func_desc=The number of bytes available in the linkset's datastore
|func_desc=リンクセットのデータストア内で利用可能なバイト数。
|return_type=integer|return_text=with the number of bytes free in the datastore.
|return_type=integer|return_text=データストア内で利用可能な空きバイト数
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 68: Line 68:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataCountKeys/ja|llLinksetDataCountKeys]]
|func=[[llLinksetDataCountKeys/ja|llLinksetDataCountKeys]]
|func_desc=Returns the number of keys used in the datastore.
|func_desc=データストアで使用されているキーの数を返します。
|return_type=integer|return_text=with the total number of keys in use.
|return_type=integer|return_text=使用中の合計キー数
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 76: Line 76:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataCountFound/ja|llLinksetDataCountFound]]
|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=パターンに一致するリンクセットのデータストア内のキーの数を返します。
|p1_type=string|p1_name=pattern|p1_desc=A regular expression describing which keys to return.
|p1_type=string|p1_name=pattern5|p1_desc=キーを記述する正規表現。
|return_type=integer|return_text=count of the keys in the datastore that match the supplied pattern.
|return_type=integer|return_text=パターンと一致するデータストア内のキーの数
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 85: Line 85:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataListKeys/ja|llLinksetDataListKeys]]
|func=[[llLinksetDataListKeys/ja|llLinksetDataListKeys]]
|func_desc=Return a list of keys currently in use in the linkset data.
|func_desc=リンクセットデータ内で現在使用中のキーのリストを返します。
|p1_type=integer|p1_name=first|p1_desc=The (zero based) index of the first key to return.
|p1_type=integer|p1_name=first6|p1_desc=最初のキーのゼロベースのインデックス。
|p2_type=integer|p2_name=count|p2_desc=The maximum number of key names to return in the list.
|p2_type=integer|p2_name=count6|p2_desc=リスト内で返すキー名の最大数
|return_type=list|return_text=of keys stored in the linkset data.
|return_type=list|return_text=リンクセットデータに格納されているキーの数
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 95: Line 95:
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=[[llLinksetDataFindKeys/ja|llLinksetDataFindKeys]]
|func=[[llLinksetDataFindKeys/ja|llLinksetDataFindKeys]]
|func_desc=Return a list of keys the linkset data which match the expression passed to the function.
|func_desc=リンクセットデータ内で、関数に渡された式に一致するキーのリストを返します。
|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=regex7|p1_desc=検索するための[https://en.wikipedia.org/wiki/Regular_expression 正規表現式]
|p2_type=integer|p2_name=first|p2_desc=The (zero based) index of the first key to return.
|p2_type=integer|p2_name=first7|p2_desc=最初のキーのゼロベースのインデックス
|p3_type=integer|p3_name=count|p3_desc=The maximum number of key names to return in the list.
|p3_type=integer|p3_name=count7|p3_desc=リスト内のキー名の最大数
|return_type=list|return_text=of keys matching regex stored in the linkset data.
|return_type=list|return_text=リンクセットデータ内に格納されている正規表現に一致するキーの数。
|func_footer
|func_footer
|caveats=none
|caveats=none
Line 107: Line 107:
{{LSL Function/Head
{{LSL Function/Head
|func=[[linkset_data/ja|linkset_data]]
|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=action8|p1_desc=リンクセットデータストアに対して実行されるアクション。リセット、更新、または削除。
|p2_type=string|p2_name=name|p2_desc=The name of key changed. Empty string for reset.
|p2_type=string|p2_name=name8|p2_desc=変更されたキーの名前。リセットの場合は空の文字列。
|p3_type=string|p3_name=value|p3_desc=The value associated with the key. Empty string for reset or delete.
|p3_type=string|p3_name=value8|p3_desc=キーに関連付けられた値。リセットまたは削除の場合は空の文字列。
|event_desc=Triggered in all scripts in a linkset when the Linkset key/value database is modified.
|event_desc=リンクセットのキー/値データベースが変更された際、リンクセット内のすべてのスクリプトでトリガーされます。
}}
}}

Latest revision as of 11:00, 9 October 2023

はじめに

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

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

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


関数

llLinksetDataWrite

Function: integer llLinksetDataWrite( string name1, string value1 );

リンクセットデータストア内にキー/値のペアを作成または更新します。
Returns an integer 成功または失敗を示すものです。0は成功を示し、正の数は失敗を示します。

• string name1 – データを格納するためのキー名。
• string value1 – このキーに関連付ける文字列データ。
Caveats

valueが空の文字列の場合、キーはリンクセットデータから削除されます。

All Issues ~ Search JIRA for related Bugs

llLinksetDataRead

Function: string llLinksetDataRead( string name2 );

リンクセットのキー値データストアからキーに関連付けられた値を読み取ります。
Returns a string キーに関連付けられたもの。キーが存在しない場合、空の文字列が返されます。

• string name2 – 読み取るデータのキー名。

llLinksetDataDelete

Function: llLinksetDataDelete( string name3 );

リンクセットのデータストアからキーと値のペアを削除します。

• string name3 – 読み取るデータのキー名

llLinksetDataDeleteFound

Function: list llLinksetDataDeleteFound( string pattern4, string pass4 );

データストア内でパターンに一致するすべてのキーを検索し、削除しようとします。
Returns a list 削除またはスキップされたキーの数。

• string pattern4 – 削除するキーを記述する正規表現。
• string pass4 – 保護されたキーを削除するためのオプションのパスフレーズ。

llLinksetDataReset

Function: llLinksetDataReset( );

リンクセットのデータストア内のすべての既存のキーと値のペアを削除します。

llLinksetDataAvailable

Function: integer llLinksetDataAvailable( );

リンクセットのデータストア内で利用可能なバイト数。
Returns an integer データストア内で利用可能な空きバイト数

llLinksetDataCountKeys

Function: integer llLinksetDataCountKeys( );

データストアで使用されているキーの数を返します。
Returns an integer 使用中の合計キー数

llLinksetDataCountFound

Function: integer llLinksetDataCountFound( string pattern5 );

パターンに一致するリンクセットのデータストア内のキーの数を返します。
Returns an integer パターンと一致するデータストア内のキーの数

• string pattern5 – キーを記述する正規表現。

llLinksetDataListKeys

Function: list llLinksetDataListKeys( integer first6, integer count6 );

リンクセットデータ内で現在使用中のキーのリストを返します。
Returns a list リンクセットデータに格納されているキーの数

• integer first6 – 最初のキーのゼロベースのインデックス。
• integer count6 – リスト内で返すキー名の最大数

llLinksetDataFindKeys

Function: list llLinksetDataFindKeys( string regex7, integer first7, integer count7 );

リンクセットデータ内で、関数に渡された式に一致するキーのリストを返します。
Returns a list リンクセットデータ内に格納されている正規表現に一致するキーの数。

• string regex7 – 検索するための正規表現式
• integer first7 – 最初のキーのゼロベースのインデックス
• integer count7 – リスト内のキー名の最大数

Events

linkset_data

Function: linkset_data( integer action8, string name8, string value8 );
• integer action8 – リンクセットデータストアに対して実行されるアクション。リセット、更新、または削除。
• string name8 – 変更されたキーの名前。リセットの場合は空の文字列。
• string value8 – キーに関連付けられた値。リセットまたは削除の場合は空の文字列。
All Issues ~ Search JIRA for related Bugs
Retrieved from "https://wiki.secondlife.com/w/index.php?title=Category:LSL_LinksetData/ja&oldid=1214956"