定義と使用法
unshift() メソッドは、array の先頭に 1 つ以上の要素を追加し、新しい長さを返します。
構文
arrayObject.unshift(newelement1,newelement2,....,newelementX)
パラメータ | 説明 |
newelement1 | 必須。配列に追加される最初の要素。 |
newelement2 | オプション。配列に追加された 2 番目の要素。 |
newelementX | オプション。いくつかの要素を追加できます。 |
戻り値
arrayObject の新しい長さ。
説明
unshift() メソッドは、そのパラメータを arrayObject の先頭に挿入し、既存の要素を上位の添字に順次移動してスペースを空けます。メソッドの最初の引数は配列の新しい要素 0 になり、2 番目の引数がある場合は新しい要素 1 になり、以下同様になります。
unshift() メソッドは新しいものを作成するのではなく、元の配列を直接変更することに注意してください。
ヒントと注意
注: このメソッドは配列の長さを変更します。
注: unshift() メソッドは Internet Explorer では正しく機能しません。
ヒント: 1 つ以上の要素を配列の末尾に追加するには、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() は、配列の先頭に 1 つ以上の要素を追加し、新しい長さを返しますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。