slice (Array.slice メソッド)

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

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

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

パラメータ

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

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

戻り値

例

次の例では、まず 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); // Returns cat,dog.
trace(myPets_array); // Returns cat,dog,fish,canary,parrot.

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

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myFlyingPets_array:Array = myPets_array.slice(-2);
trace(myFlyingPets_array); // Traces canary,parrot.

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

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");
var myAquaticPets_array:Array = myPets_array.slice(2,-2);
trace(myAquaticPets_array); // Returns fish.