slice (Array.slice-Methode)

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

Gibt ein neues Array zurück, das aus mehreren Elementen des ursprünglichen Arrays besteht, ohne das ursprüngliche Array dabei zu ändern. Das zurückgegebene Array umfasst das Element startIndex und alle Elemente bis (ausschließlich) zum Element endIndex.

Wenn Sie keine Parameter übergeben, wird eine Kopie des ursprünglichen Arrays erstellt.

Parameter

startIndex:Number [optional] - Eine Zahl, die die Indexposition des Segmentanfangs angibt. Wenn start eine negative Zahl ist, liegt der Ausgangspunkt am Ende des Arrays, wobei -1 das letzte Element ist.

endIndex:Number [optional] - Eine Zahl, die die Indexposition des Segmentendes angibt. Wenn Sie diesen Parameter weglassen, umfasst das Segment alle Elemente vom Anfang bis zum Ende des Arrays. Wenn end eine negative Zahl ist, wird der Endpunkt vom Ende des Arrays aus berechnet, wobei -1 das letzte Element ist.

Rückgabewerte

Array - Ein Array, das aus mehreren Elementen des ursprünglichen Arrays besteht.

Beispiel

Im folgenden Beispiel wird ein Array mit fünf Tieren erstellt. Anschließend wird mithilfe von slice() ein neues Array mit Daten versehen (nur vierbeinige Tiere):

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); // Rückgabewert: cat,dog
trace(myPets_array); // Rückgabewert: cat,dog,fish,canary,parrot

Im folgenden Beispiel wird ein Array mit fünf Tieren erstellt. Anschließend werden mithilfe von slice() und einem negativen start-Parameter die beiden letzten Elemente des Arrays kopiert:

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

Im folgenden Beispiel wird ein Array mit fünf Tieren erstellt. Anschließend werden mithilfe von slice() und einem negativen end-Parameter die mittleren Elemente des Arrays kopiert:

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