Flash Lite 2 
Flash Lite 2.x ActionScript リファレンスガイド > ActionScript クラス > String > split (String.split メソッド)

split (String.split メソッド)

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

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

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

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

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

"ActionScript" サンプルのフォルダの "Strings.fla" ファイルにも例が収められています。通常、このフォルダへのパスは次のようになります。

関連項目

join (Array.join メソッド)