定義與用法
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()的詳細內容。更多資訊請關注PHP中文網其他相關文章!