public split(delimiter:String, [limit:Number]) : Array

指定された delimiter パラメータがある各位置で String オブジェクトをサブストリングに分割し、そのサブストリングを配列として返します。区切り記号として空のストリング ("") を使用すると、ストリング内の各文字がエレメントとして配列に挿入されます。

delimiter パラメータが未定義の場合は、ストリング全体が返される配列の最初のエレメントに挿入されます。

パラメータ

delimiter:String - ストリング。my_str を分割する文字またはストリング。

limit:Number (オプション) - 配列に挿入する項目数。

戻り値

Array - my_str のサブストリングを含む配列。

例

次の例では、5 つのエレメントで構成される配列を返します。

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",");
for (var i = 0; i<my_array.length; i++) {
    trace(my_array[i]);
}
// 出力
    P
    A
    T
    S
    Y

次の例では、2 つのエレメント "P" および "A" で構成される配列を返します。

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",", 2);
trace(my_array); // 出力 : P,A

次の例に示すように、delimiter パラメータに空のストリング ("") を使用すると、ストリング内の各文字がエレメントとして配列に挿入されます。

var my_str:String = new String("Joe");
var my_array:Array = my_str.split("");
for (var i = 0; i<my_array.length; i++) {
    trace(my_array[i]);
}
// 出力
    J
    o
    e

www.adobe.com/go/learn_fl_samples_jp の "ActionScript" サンプルフォルダにある "Strings.fla" ファイルにも例があります。.zip ファイルをダウンロードして解凍し、ActionScript バージョンのフォルダに移動してサンプルにアクセスします。

関連項目

join (Array.join メソッド)