LlGetListLength/ja

From Second Life Wiki

メインページ > LlGetListLength > LlGetListLength/ja
Jump to: navigation, search

関数: integer llGetListLength( list src );

リスト src にある要素数のinteger値を返します。

• list src

警告

  • LSL コンパイラは条件文に関する最適化を行ないません。(条件文の外側に関数を引き出したりはしません。) 動的なデータを精密に扱うといったケースで無いならば、string 値・key 値・list 値の長さ計算は、ループの外側で行なわれるべきです。詳しくは使用上の工夫を参照してください。

//Basic usage
default
{
    state_entry()
    {
        list l = ["one", "two", "three"];
        integer i = llGetListLength(l);
        llOwnerSay("there are " + (string)i + " entries in the list");
    }
}

ノート

使用上の工夫

リストのループ処理でリストの長さを使う際は、あらかじめリストの長さを求めておき、それからループ処理に入った方が良いです:

 
integer i = 0;
integer length = llGetListLength(mylist);
for (; i < length; ++i) {
    llSay(0, llList2String(mylist, i));
}
 

以下は、やらない方が良い例です。for ループの各繰り返し毎にリストの長さを再計算しているので、非効率になっています。ループの各繰り返し毎にリストの長さが実際変化するという場合のみ、この方法はとられるべきです[1]

 
integer i;
for (i = 0; i < llGetListLength(mylist); ++i) {
    llSay(0, llList2String(mylist, i));
}
 

最適化

リストの長さの評価をより速く、より小さい (バイト コードの) サイズで済ます方法は、"!=" で空のリストと比較する事です。これは、リストを "!=" で比較すると、その長さの比較になるためです。

 
list in;
integer len_in = llGetListLength(in);
integer flen_in = (in != []);
//flen_in と len_in は等しい
 
integer neg_len_in = -llGetListLength(in);
integer fneg_len_in = ([] != in);
//fneg_len_in と neg_len_in は等しい
 

関連項目

関数

•  llListStatistics LIST_STAT_NUM_COUNT – リスト内の integer 型データと float 型データの個数を返します。
•  llStringLength string 値の文字数を返します。

ディープノート

情報源

'linden\indra\lscript\lscript_library\lscript_alloc.cpp' @ lsa_cmp_lists
'linden\indra\lscript\lscript_execute\lscript_execute.cpp' @ list_list_operation

Footnotes

  1. ^ list 変数がスタック領域に置かれている場合は VM がリスト全体を (値も含めて) コピーするため、リストの長さの再計算は時間がかかります。(計算が済むとスタック領域から除かれます。)
この項目はあなたにとって参考にならない項目ですか?もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。
In other languages