Array

Team-Fly    

 
Webmaster in a Nutshell, 3rd Edition
By Robert Eckstein, Stephen Spainhour
Table of Contents
Chapter 11.  JavaScript


Array Core JavaScript 1.1; JScript 2.0; ECMA v1

Array creation and manipulation

Constructor

 new Array( )             // empty new Array(  n  )            // n undefined elements new Array(  e0  ,  e1  ,...)   // specified elements 

Literal Syntax

In JavaScript 1.2, JScript 3.0, and ECMA v3, you can create and initialize an array by placing a comma-separated list of expressions within square brackets. The values of these expressions become the elements of the array. For example:

 var a = [1, true, 'abc']; var b = [a[0], a[0]*2, f(x)]; 

Properties

length

A read/write integer specifying the number of elements in the array, or, when the array does not have contiguous elements, a number one larger than the index of the last element in the array. Changing the value of this property truncates or extends the array.

Methods

concat( value, ... )

Returns a new array, which is formed by concatenating each of the specified arguments to this one. If any arguments to concat( ) are themselves arrays, their elements are concatenated , rather than the arrays themselves . JS 1.2; JScript 3.0; ECMA v3.

join( separator )

Returns the string that results from converting each element of an array to a string and then concatenating the strings together, with the separator string between elements.

pop( )

Removes and returns the last element of the array, decrementing the array length. JS 1.2; JScript 5.5; ECMA v3.

push( value, ... )

Appends the specified value or values to the end of the array, and returns the new length of the array. JS 1.2; JScript 5.5; ECMA v3.

reverse( )

Reverses the order of the elements of an array. Returns nothing.

shift( )

Removes and returns the first element of the array, shifting subsequent elements down one and decrementing the array length. JS 1.2; JScript 5.5; ECMA v3.

slice( start , end )

Returns a new array that contains the elements of the array from the element numbered start , up to, but not including, the element numbered end . JS 1.2; JScript 3.0; ECMA v3.

sort ( orderfunc )

Sorts the elements of an array, and returns a reference to the array. Note that the array is sorted in place and no copy is made. The optional orderfunc argument may specify a function that defines the sorting order. The function should expect two arguments and should return a value that is less than 0 if the first argument is less than the second, 0 if they are equal, and a value greater that 0 if the first is greater than the second.

splice( start , deleteCount , value,... )

Deletes the specified number of elements from the array starting at the specified index, then inserts any remaining arguments into the array at that location. Returns an array containing the deleted elements. JS 1.2; JScript 5.5; ECMA v3.

toLocaleString( )

Returns a localized string representation of the array. JS 1.5; JScript 5.5; ECMA v1.

toString( )

Returns a string representation of array .

unshift( value, ... )

Inserts the argument or arguments as new elements at the beginning of an array, shifting existing array elements up to make room. Returns the new length of the array. JS 1.2; JScript 5.5; ECMA v3.


Team-Fly    
Top


Webmaster in a Nutshell
Webmaster in a Nutshell, Third Edition
ISBN: 0596003579
EAN: 2147483647
Year: 2002
Pages: 412

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