View source for Dataserver/ja

{{Issues/SVC-2596}}{{LSL_Event/ja
|event_id=24|event_delay|event=dataserver
|p1_type=key|p1_name=queryid|p1_desc=リクエストした関数の復帰値と一致します
|p2_type=string|p2_name=data|p2_desc=リクエストしたデータ (必要に応じて string に型変換)
|event_desc=タスクが非同期でデータを取得したときに発生します。
|constants
|spec
|constants={{{!}} {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
! 関数
! colspan="2" {{!}}入力
! Decode
! colspan="4" {{!}} 説明
{{!}}-
{{!}} colspan="3" {{!}} {{LSLG/ja|llGetNotecardLine}}
{{!}} {{LSLG|string}}
{{!}} colspan="4" {{!}} リクエストされたノートカードの行数は、 255 バイト以内である必要があります。 <br/> {{LSLG/ja|EOF}} の場合、リクエストされた行は最終行を超えています。
{{!}}-
{{!}} colspan="3" {{!}} {{LSLG/ja|llGetNumberOfNotecardLines}}
{{!}} ({{LSLG/ja|integer}})
{{!}} colspan="4" {{!}} リクエストしたノートカードの行数。
{{!}}-
{{!}} rowspan="7" {{!}} {{LSLG/ja|llRequestAgentData}}
{{LSL Constants/llRequestAgentData/ja}}
{{!}}-
{{!}} colspan="3" {{!}} {{LSLG/ja|llRequestDisplayName}}
{{!}} ({{LSLG/ja|string}})
{{!}} colspan="4" {{!}} エージェントの表示名
{{!}}-
{{!}} colspan="3" {{!}} {{LSLG/ja|llRequestUsername}}
{{!}} ({{LSLG/ja|string}})
{{!}} colspan="4" {{!}} エージェントのユーザ名 (レガシー形式: "first.last")
{{!}}-
{{!}} rowspan="1" {{!}} {{LSLG/ja|llRequestInventoryData}}
{{LSL Constants/llRequestInventoryData/ja}}
{{!}}-
{{!}} rowspan="9" {{!}} {{LSLG/ja|llRequestSimulatorData}}
{{LSL Constants/llRequestedSimulatorData/ja}}
{{!}}}
|caveats=
*dataserver は必ずしもリクエストした順番を守って現れるわけではありません。
**リクエストが複数たまることがある場合、常に queryid キーを使用して、どの回答を受け取ったかを判断するようにしましょう。
*dataserver をリクエストすると、リクエストのあったプリムと同じプリムの全てのスクリプトで '''dataserver''' イベントが発生します。
**同じプリムで '''dataserver''' イベントを複数発生させることがある場合、常に queryid キーを使用して、どの回答を受け取ったかを判断するようにしましょう。
**'''dataserver''' イベントは同じリンクセットの中の違うプリムの中のスクリプトでは発生しません。
*'''dataserver''' イベントの前に同じ query_id で他のデータがリクエストされていると、結果データはめちゃくちゃになります。データの破壊を防ぐには、 {{LSLG/ja|if}}(query_key == query_id) というような問い合わせを行ってください。しかしこれには欠点があります (上の警告を見てください) 。
|notes=*'''dataserver''' イベントでデータをリクエストしても全然いいのですが、イベントの中で無限ループが発生しないように気をつけてください。ループが終了するまでイベントは実行されっぱなしになり、そこで生成された全てのリクエストが最初の取得したときのデータで送りこまれることになります。
|examples=<source lang="lsl2">key kQuery;
integer iLine = 0;
default {
    
    state_entry() {
        llSay(0, "Reading notecard...");
        kQuery = llGetNotecardLine("My Notecard", iLine);
    }

    dataserver(key query_id, string data) {

        if (query_id == kQuery) {
            // ノートカードの行数
            if (data == EOF) {    

                llSay(0, "No more lines in notecard, read " + (string)iLine + " lines.");

            } else {

                // 行数をインクリメント
                llSay(0, "Line " + (string)iLine + ": " + data);
                
                //次の行をリクエスト
                ++iLine;
                kQuery = llGetNotecardLine("My Notecard", iLine);

            }
        }
    }
}</source>
|helpers
|also_header
|also_events
|also_functions
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Dataserver
|cat2=Notecard
|cat3=Inventory
|cat4=Region
|cat5=Script
|cat6=Prim
|cat7=Avatar
|cat8=Avatar/Name
}}