User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

111

112

113

114

115

116

117

118

119

120

Array.slice() 113

Array.slice()

Availability

Flash Player 5.

Usage

my_array.slice( [ start:Number [ , end:Number ] ] ) : Array

Parameters

start

A number specifying the index of the starting point for the slice. If start is a negative

number, the starting point begins at the end of the array, where -1 is the last element.

end A number specifying the index of the ending point for the slice. If you omit this parameter,

the slice includes all elements from the starting point to the end of the array. If

end is a negative

number, the ending point is specified from the end of the array, where -1 is the last element.

Returns

An array.

Description

Method; returns a new array that consists of a range of elements from the original array, without

modifying the original array. The returned array includes the

start element and all elements up

to, but not including, the

end element.

If you don’t pass any parameters, a duplicate of

my_array is created.

Example

The following example creates an array of five pets and uses slice() to populate a new array

comprising only four-legged pets:

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

The following example creates an array of five pets, and then uses slice() with a negative start

parameter to copy the last two elements from the array:

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

The following example creates an array of five pets and uses slice() with a negative end

parameter to copy the middle element from the array:

var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot");