public substring(start:Number, end:Number) : String

start パラメータと end パラメータで指定された点の間の文字をストリングとして返します。end パラメータを指定しないと、サブストリングの終わりはストリングの終わりです。start が end と等しい場合、空白のストリングが返されます。start の値が end の値を超えると、2 つのパラメータは入れ替えられて関数が実行されます。元の値は変更されません。

パラメータ

start:Number - サブストリングを作成するために使用する my_str の開始位置を示す整数。start パラメータに指定できる値は、0 ～ String.length - 1 です。start パラメータに負数を指定した場合は、0 が使われます。

end:Number - my_str から取り出す最後の文字のインデックスに 1 を加えた整数。end に指定できる値は、1 ～ String.length です。end パラメータで指定されたインデックス位置の文字は、取り出されるストリングには含まれません。このパラメータを省略すると、String.length が使用されます。このパラメータが負の値である場合は、0 が使用されます。

戻り値

String - 指定されたストリングのサブストリング。

例

次の例では、substring() の使用方法を示します。

var my_str:String = "Hello world";
var mySubstring:String = my_str.substring(6,11);
trace(mySubstring); // 出力 : world

次に、負の start パラメータを使用した場合の例を示します。

var my_str:String = "Hello world";
var mySubstring:String = my_str.substring(-5,5);
trace(mySubstring); // 出力 : Hello

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