push 方法
将新元素添加到一个数组中,并返回数组的新长度值。
arrayobj.push([item1 [item2 [. . . [itemn ]]]])
参数
arrayobj 必选项。一个 array 对象。
item, item2,. . . itemn 可选项。该 array 的新元素。
说明
push 方法将以新元素出现的顺序添加这些元素。如果参数之一为数组,那么该数组将作为单个元素添加到数组中。如果要合并两个或多个数组中的元素,请使用 concat 方法。
示例
要求
版本 5.5
pop 方法
移除数组中的最后一个元素并返回该元素。 arrayobj.pop()
必选的 arrayobj 引用是一个 array 对象。
说明
如果该数组为空,那么将返回 undefined。
示例
要求
版本 5.5
shift 方法
移除数组中的第一个元素并返回该元素。 arrayobj.shift( )
参数
必选的 arrayobj 引用是一个 array 对象。
说明
shift 方法可移除数组中的第一个元素并返回该元素。
要求
版本 5.5
unshift 方法
将指定的元素插入数组开始位置并返回该数组。 arrayobj.unshift([item1[, item2 [, . . . [, itemn]]]])
参数
arrayobj 必选项。一个 array 对象。
item1, item2,. . .,itemn 可选项。将插入到该 array 开始部分的元素。
说明
unshift 方法将这些元素插入到一个数组的开始部分,所以这些元素将以参数序列中的次序出现在数组中。
要求
版本 5.5
concat 方法 (array)
返回一个新数组,这个新数组是由两个或更多数组组合而成的。 array1.concat([item1[, item2[, . . . [, itemn]]]])
参数
array1 必选项。其他所有数组要进行连接的 array 对象。
item1,. . ., itemn 可选项。要连接到 array1 末尾的其他项目。
说明
concat 方法返回一个 array 对象,其中包含了 array1 和提供的任意其他项目的连接。
要加的项目(item1 … itemn)会按照从左到右的顺序添加到数组。如果某一项为数组,那么添加其内容到 array1 的末尾。如果该项目不是数组,就将其作为单个的数组元素添加到数组的末尾。
以下为从源数组复制元素到结果数组:
对于从正被连接到新数组的数组中复制的对象参数,复制后仍然指向相同的对象。不论新数组和源数组中哪一个有改变,都将引起另一个的改变。
对于连接到新数组的数值或字符串,只复制其值。一个数组中值有改变并不影响另一个数组中的值。
示例
下面这个例子说明了使用数组时 concat 方法的用法:
function concatarraydemo(){
var a, b, c, d;
a = new array(1,2,3);
b = jscript;
c = new array(42, vbscript);
d = a.concat(b, c);
// 返回数组 [1, 2, 3, jscript, 42, vbscript]
return(d);
}
要求
版本 3
join 方法
返回字符串值,其中包含了连接到一起的数组的所有元素,元素由指定的分隔符分隔开来。 arrayobj.join(separator)
参数
arrayobj 必选项。array 对象。
separator 必选项。是一个 string 对象,作为最终的 string 对象中对数组元素之间的分隔符。如果省略了这个参数,那么数组元素之间就用一个逗号来分隔。
说明
如果数组中有元素没有定义或者为 null,将其作为空字符串处理。
示例
下面这个例子说明了 join 方法的用法。
function joindemo(){
var a, b;
a = new array(0,1,2,3,4);
b = a.join(-);
return(b);
}
要求
版本 2
sort 方法
返回一个元素已经进行了排序的 array 对象。 arrayobj.sort(sortfunction)
参数
arrayobj 必选项。任意 array 对象。
sortfunction 可选项。是用来确定元素顺序的函数的名称。如果这个参数被省略,那么元素将按照 ascii 字符顺序进行升序排列。
说明
sort 方法将 array 对象进行适当的排序;在执行过程中并不会创建新的 array 对象。
如果为 sortfunction 参数提供了一个函数,那么该函数必须返回下列值之一:
(1)负值,如果所传递的第一个参数比第二个参数小。
(2)零,如果两个参数相等。
(3)正值,如果第一个参数比第二个参数大。
示例
要求
版本 2
slice 方法 (array)
返回一个数组的一段。 arrayobj.slice(start, [end])
参数
arrayobj 必选项。一个 array 对象。
start 必选项。arrayobj 中所指定的部分的开始元素是从零开始计算的下标。
end 可选项。arrayobj 中所指定的部分的结束元素是从零开始计算的下标。
说明
slice 方法返回一个 array 对象,其中包含了 arrayobj 的指定部分。
slice 方法一直复制到 end 所指定的元素,但是不包括该元素。如果 start 为负,将它作为 length + start处理,此处 length 为数组的长度。如果 end 为负,就将它作为 length + end 处理,此处 length 为数组的长度。如果省略 end ,那么 slice 方法将一直复制到 arrayobj 的结尾。如果 end 出现在 start 之前,不复制任何元素到新数组中。
示例
在下面这个例子中,除了最后一个元素之外,myarray 中所有的元素都被复制到 newarray 中: newarray = myarray.slice(0, -1)
splice 方法
从一个数组中移除一个或多个元素,如果必要,在所移除元素的位置上插入新元素,返回所移除的元素。 arrayobj.splice(start, deletecount, [item1[, item2[, . . . [,itemn]]]])
参数
arrayobj 必选项。一个 array 对象。
start 必选项。指定从数组中移除元素的开始位置,这个位置是从 0 开始计算的。
deletecount 必选项。要移除的元素的个数。
item1, item2,. . .,itemn 必选项。要在所移除元素的位置上插入的新元素。
说明
splice 方法可以移除从 start 位置开始的指定个数的元素并插入新元素,从而修改 arrayobj。返回值是一个由所移除的元素组成的新 array 对象。
要求
版本 5.5
reverse 方法
返回一个元素顺序被反转的 array 对象。 arrayobj.reverse( )
参数
arrayobj 必选项,该参数为 array 对象。
说明
reverse 方法将一个 array 对象中的元素位置进行反转。在执行过程中,这个方法并不会创建一个新的 array 对象。
如果数组是不连续的,reverse 方法将在数组中创建元素以便填充数组中的间隔。这样所创建的全部元素的值都是 undefined。
示例
下面这个例子说明了 reverse 方法的用法:
function reversedemo(){
var a, l; // 声明变量。
a = new array(0,1,2,3,4); // 创建数组并赋值。
l = a.reverse(); // 反转数组的内容。
return(l); // 返回结果数组。
}