User Guide

112 Chapter 2: ActionScript Language Reference

Array.shift()

Availability

Flash Player 5.

Usage

my_array.shift() : Object

Parameters

None.

Returns

The first element in an array.

Description

Method; removes the first element from an array and returns that element.

Example

The following code creates the array myPets_array and then removes the first element from the

array and assigns it to the variable

shifted:

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

var shifted:String = myPets_array.shift();

trace(shifted); // displays "cat"

trace(myPets_array); // displays dog,bird,fish