定义和用法
unshift() 方法可向数组的开头添加一个或更多元素,并返回新的长度。
语法
arrayobject.unshift(newelement1,newelement2,....,newelementx)
参数 描述
newelement1 必需。向数组添加的第一个元素。
newelement2 可选。向数组添加的第二个元素。
newelementx 可选。可添加若干个元素。
返回值
arrayobject 的新长度。
说明
unshift() 方法将把它的参数插入 arrayobject 的头部,并将已经存在的元素顺次地移到较高的下标处,以便留出空间。该方法的第一个参数将成为数组的新元素 0,如果还有第二个参数,它将成为新的元素 1,以此类推。
请注意,unshift() 方法不创建新的创建,而是直接修改原有的数组。
提示和注释
注释:该方法会改变数组的长度。
注释:unshift() 方法无法在 internet explorer 中正确地工作!
提示:要把一个或多个元素添加到数组的尾部,请使用 push() 方法。
实例
在本例中,我们将创建一个数组,并把一个元素添加到数组的开头,并返回数组的新长度:
<script type="text/javascript">
var arr = new array()
arr[0] = "george"
arr[1] = "john"
arr[2] = "thomas"
document.write(arr + "<br />")
document.write(arr.unshift("william") + "<br />")
document.write(arr)
</script>
输出:
george,john,thomas
4
william,george,john,thomas
例子:
<html>
<head>
<title>javascript array unshift method</title>
</head>
<body>
<script type="text/javascript">
var arr = new array("orange", "mango", "banana", "sugar");
var length = arr.unshift("water");
document.write("returned array is : " + arr );
document.write("<br /> length of the array is : " + length );
</script>
</body>
</html>
这将产生以下结果:
returned array is : water,orange,mango,banana,sugar
length of the array is : 5
以上就是javascript向数组开头添加一个或更多元素并返回新的长度的方法unshift()的详细内容。