Section 24.19. Array.unshift( ): insert elements at the beginning of an array


24.19. Array.unshift( ): insert elements at the beginning of an array

ECMAScript v3

24.19.1. Synopsis

array.unshift(value, ...)

24.19.1.1. Arguments

value, ...

One or more values that are inserted at the start of array.

24.19.1.2. Returns

The new length of the array.

24.19.2. Description

unshift( ) inserts its arguments at the beginning of array, shifting the existing elements to higher indexes to make room. The first argument to shift( ) becomes the new element 0 of the array; the second argument, if any, becomes the new element 1; and so on. Note that unshift( ) does not create a new array; it modifies array directly.

24.19.3. Example

unshift( ) is often used in conjunction with shift( ). For example:

 var a = [];             // a:[] a.unshift(1);           // a:[1]          Returns: 1 a.unshift(22);          // a:[22,1]       Returns: 2 a.shift( );                // a:[1]          Returns: 22 a.unshift(33,[4,5]);    // a:[33,[4,5],1] Returns: 3 

24.19.4. See Also

 Array.shift( ) 




JavaScript. The Definitive Guide
JavaScript: The Definitive Guide
ISBN: 0596101996
EAN: 2147483647
Year: 2004
Pages: 767

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net