View source

{{LSL_Function/negative index/ja|true|start|end}}{{LSL_Function/ja
|func_id=296|func_sleep=0.0|func_energy=10.0
|func=llListReplaceList|return_type=list
|p1_type=list|p1_name=dest|p1_desc=置き換え対象のリスト
|p2_type=list|p2_name=src|p2_desc=置き換え後のリスト
|p3_type=integer|p3_name=start
|p4_type=integer|p4_name=end
|func_footnote
|func_desc=list 変数の一部を別の list 変数に置き換えて返します。
|return_text='''dest''' のうち '''start''' から '''end''' の範囲を取り除き、その '''start''' の位置へ '''src''' を挿入したリスト
|spec
|caveats=
*'''start''' が '''dest''' の末尾より大きい場合、'''src''' は常に '''dest''' の末尾直後に追加されます。'''start''' の位置を '''dest''' でも保持したい場合、あらかじめ空の要素を '''dest''' の末尾に追加しておいてください。同様の結果は {{LSLGC|Negative Index/ja|負のインデックス}} の場合も起こります。
*関数の呼び出しそのものは、引数の list 変数を変更しません。(戻り値を直接操作するのでないならば) 戻り値を変数へ代入しなければなりません。
:{{{!}}
{{LSL DefineRow|'''誤:'''|<code>llListReplaceList(a, ["c"], 2, 2)</code>}}
{{LSL DefineRow|'''正:'''|<code>a {{=}} llListReplaceList(a, ["c"], 2, 2)</code>}}
{{!}}}
*引数の list 変数に戻り値を再度代入するならば、代入前に list 変数を空にしておくとメモリ節約になります。
:{{{!}}
{{LSL DefineRow|'''正:'''| <code>a {{=}} llListReplaceList(a, ["c"], 2, 2)</code>}}
{{LSL DefineRow|'''最善:'''|<code>a {{=}} llListReplaceList((a {{=}} []) + a, ["c"], 2, 2)</code>}}
{{!}}}

|constants
|examples=
<lsl>default
{
    state_entry()
    {
        list a = ["a", "b", "e", "d"];
        //2 から始まり 2 で終わる範囲を ["c"] で置き換え、b に代入する
         list b = llListReplaceList(a, ["c"], 2, 2);

        //display the change
        llOwnerSay("\""+llList2CSV(a) + "\"  ->  \"" + llList2CSV(b)+"\"");
        //以下のように表示される: "a, b, e, d"  ->  "a, b, c, d"
    }
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow|{{LSLG/ja|llDeleteSubList}}|}}
{{LSL DefineRow|{{LSLG/ja|llListInsertList}}|}}
{{LSL DefineRow|{{LSLG/ja|llList2List}}|}}
|also_events
|also_tests=
{{LSL DefineRow|[[llListReplaceList Test]]|}}
|also_articles
|notes=
正確に言うと、挿入先の list 変数に多くの要素がある必要はありません。角括弧で囲まれた一つの要素からなる list 変数でも構いません。

<lsl>list TargetList = ["a", "b", "c", "z", "e"];
list InsertList = ["d"];</lsl>

list 変数中の一個の要素だけを置き換え対象にする場合、そのインデックスを start と end 両方に指定してください。例えば 0, 0 と指定した場合は先頭の要素だけ、7, 7 と指定した場合は 8 番目の要素だけが置き換え対象になります。

llListReplaceList と同様の処理を、一定間隔の飛び石要素について実行する関数については [[ListStridedUpdate]] を参照してください。
|permission
|sort=ListReplaceList
|cat1=List
|cat2
|cat3
|cat4
}}