View source

{{LSL_Function/ja
|func_id=196|func_sleep=0.0|func_energy=10.0
|func=llCSV2List|return_type=list|p1_type=string|p1_name=src
|func_footnote=
リストをカンマ区切り形式へ変換する場合は {{LSLG/ja|llList2CSV}} を使ってください。<br/>
この関数が扱うのは、厳密な意味での {{Wikipedia|CSV|CSV|lang=ja}} 形式では''ありません''。
|func_desc=この関数は、各要素がカンマで区切られた文字列を受け取り、list 変数へ変換します。
|return_text=カンマ区切り形式の文字列 '''src''' を切り分けたリスト
|spec=
=== Vector 値と Rotation 値 {{Anchor|Vectors_.26_Rotations}}===
"<" と ">" の間にある内容は全て、カンマの有無に関わらず、一個の値とみなされます

すなわち {{LSLG/ja|vector}} 値や {{LSLG/ja|rotation}} 値は、一個の {{LSLG/ja|string}} 値として扱われ、それ以上の型変換は行なわれません。

"<" には常に対応する ">" が必要というのは注意すべき点で、これが無いと残りの文字列を一続きのものとして解釈してしまいます。例えば、

{{{!}}
{{LSL DefineRow||&#32;<code>llCSV2List("<>,>,a")</code>|の戻り値は <code>["<>", ">", "a"]</code>|(二番目の ">" が孤立しています)}}
{{LSL DefineRow||&#32;<code>llCSV2List("<<>,>,a")</code>|の戻り値は <code>["<<>,>", "a"]</code>|(どの括弧もペアになっています)}}
{{LSL DefineRow||&#32;<code>llCSV2List("<<<>,>,a")</code>|の戻り値は <code>["<<<>,>,a"]</code>|(三番目の "<" には対応する閉じ括弧がありません)}}
{{!}}}

=== Whitespace ===

llCSV2List は全要素から先頭と末尾のスペースを自動的に取り除きます

<lsl>list tmp = llCSV2List("first , second , third");
// ["first","second","third"] が返ります。
// ["first "," second "," third"] ではありません。</lsl>
|caveats=
* "<" に対応する ">" が無い場合、たとえ途中に "<" がまたあったとしても、文字列の残りの部分は一つの値と見なされます。詳細は[[#Vectors_.26_Rotations|Vector値とRotation値]]の項を参照してください。
* 戻り値の全ての要素は string 型です。
* 全ての要素について、先頭と末尾のスペースは削除されます。
* 空文字列を切り分けた場合、戻り値は空のリストでなく、空文字列が入ったリスト [""] になります。
|constants
|examples=
<lsl>default
{
    state_entry()
    {
        string csv = "first,second,third";
        list my_list = llCSV2List(csv);
        llOwnerSay("CSV: " + csv);
        integer i;
        for (i=0; i<llGetListLength(my_list); ++i)
        {
            llOwnerSay("my_list[" + (string)i + "]: " + llList2String(my_list,i));
        }
    }
}</lsl>
|helpers
|also_functions={{LSL DefineRow||{{LSLG/ja|llList2CSV}}|}}
{{LSL DefineRow||{{LSLG/ja|llDumpList2String}}|}}
{{LSL DefineRow||{{LSLG/ja|llParseString2List}}|}}
{{LSL DefineRow||{{LSLG/ja|llParseStringKeepNulls}}|}}
|also_events
|also_tests
|also_articles={{LSL DefineRow||{{LSLG/ja|Typecast}}|}}
|notes=カンマ以外の区切り文字を使う場合、例えばユーザの自由入力 (それ自体カンマを含んでいる) を扱うのでカンマが区切り記号として適切でないといった場合などは、代わりに {{LSLG/ja|llParseString2List}} を使うことでカンマ以外の区切り記号を指定できます。ただし {{LSLG/ja|llParseString2List}} は rotation 型や vector 型の処理に必要な、括弧対応を踏まえた切り分けは行なわず、各要素の前後にあるスペースの削除も行ないません。
|permission
|negative_index
|sort=CSV2List
|cat1=List
|cat2=String
|cat3=Data Conversion
|cat4=CSV
}}