public slice([startIndex:Number], [endIndex:Number]) : Array

元の配列から一連のエレメントを取り出して、新しい配列を返します。元の配列は変更されません。返される配列には、startIndex エレメントから endIndex エレメントまでのエレメントがすべて含まれます。endIndex エレメント自体は含まれません。

パラメータを何も渡さないと、元の配列の複製が作成されます。

パラメータ

startIndex:Number (オプション) - スライスの始点のインデックスを指定する数値。start が負の数値の場合、始点は配列の末尾から指定されます。つまり、-1 が最後のエレメントです。

endIndex:Number (オプション) - スライスの終点のインデックスを指定する数値。このパラメータを省略すると、スライスには配列の始点から最後までのすべてのエレメントが取り込まれます。end が負の数値の場合、終点は配列の末尾から指定されます。つまり、-1 が最後のエレメントです。

戻り値

Array - 元の配列から一連のエレメントを取り出した配列。

例

次の例では、まず 5 種類のペットで構成される配列を作成し、次に slice() を使用して、4 足動物のみを含む新しい配列を作成します。

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myFourLeggedPets_array:Array = new Array();
var myFourLeggedPets_array = myPets_array.slice(0, 2);
trace(myFourLeggedPets_array); // cat,dog を返します。
trace(myPets_array); // cat,dog,fish,canary,parrot を返します。

次の例では、5 種類のペットで構成される配列を作成し、次に負数の start パラメータを設定した slice() を使用して、配列から最後の 2 つのエレメントをコピーします。

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myFlyingPets_array:Array = myPets_array.slice(-2);
trace(myFlyingPets_array); // canary,parrot をトレースします。

次の例では、5 種類のペットで構成される配列を作成し、次に負数の end パラメータを設定した slice() を使用して、配列から中間のエレメントをコピーします。

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myAquaticPets_array:Array = myPets_array.slice(2,-2);
trace(myAquaticPets_array); // fish を返します。