Name

Array.shift( ) Method — remove the first element of an array

Availability

Flash 5

Synopsis

array.shift( )

Returns

The value of the first element of array, which is also deleted.

Description

The shift( ) method deletes the first element of an array and then moves all the remaining elements of the array up one position. The affected array’s length is reduced by 1. Note that shift( ) differs from the pop( ) method, which deletes the last element of an array.

Example

myList = new Array ("a", "b", "c");
myList.shift( );                                  // myList becomes ["b", "c"]

See Also

Array.pop( ), Array.splice( ), Array.unshift( ); “Removing Elements from an Array” in Chapter 11

Get ActionScript: The Definitive Guide now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.