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

slice (Array.slice メソッド)

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

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

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

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

パラメータ

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 種類のペットで構成される配列を作成し、次に 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); // 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); // fish を返す