prototype.jsリファレンス配列(Array)
- 配列から特定の要素を取り除く〔without()〕
- 配列をリセット〔clear()〕
- 配列をコピー〔clone()〕
- 配列の先頭から要素を取り除く〔shift()〕
- 配列をフラット配列に変換〔flatten()〕
- 配列の長さを返す〔length〕
- reduce〔reduce()〕
- 配列から重複する値を削除〔uniq()〕
- 配列の最初の要素、最後の要素を取得〔firs()、last()〕
- 配列要素を可読可能な文字列に変換〔inspect()〕
- 配列をJSON形式に変換〔toJSON()〕
- 配列要素を検索〔indexOf()〕
- 値がnull、undefinedの要素を削除〔compact()〕
- 配列要素を逆順に並び替え〔reverse()〕
配列から特定の要素を取り除く
without()
unknown
newArray=対象となる配列オブジェクト.without(value[, value, ...]);
指定した値の要素を配列から削除した、新しい配列を返します(元配列に変化なし)。
第1引数valueには、取り除く値を指定します。 取り除く値が複数ある場合は、カンマ区切りで指定します。
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("取除前="+fruits.inspect()+"<br>"); var without_fruit=fruits.without("orange","remon","banana"); document.write("結果="+without_fruit.inspect()+"<br>"); document.write("取除後="+fruits.inspect()+"<br><br>"); </script>
配列をリセット
clear()
unknown
配列オブジェクト.clear(); → Array
配列内の要素をすべて削除して返します(元配列自体が変化)。
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("削除前="+fruits.toString()+"<br>"); fruits.clear(); document.write("削除後="+fruits.toString()+"<br>"); </script>
配列をコピー
clone()
unknown
結果の配列=対象となる配列オブジェクト.clone(); → newArray
指定した配列をコピーします。 コピー元の配列が変化しても、コピー先の配列(クローン)は変化しません。
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; var fruits2=[ ["apple", "200"], ["orange", "500"], ["remon", "80"], ["grape", "1000"] ]; var clone=fruits.clone(); var clone2=fruits2.clone(); document.write("clone="+clone.inspect()+"<br>"); document.write("clone2="+clone2.inspect()+"<br>"); fruits.pop(); document.write("fruits="+fruits.inspect()+"<br>"); document.write("clone="+clone.inspect()+"<br>"); </script>
配列の先頭から要素を取り除く
shift()
unknown
対象となる配列オブジェクト.shift(); → 取り除かれた配列の最初の要素
配列から先頭の要素を削除し、削除した要素を返します(元配列自体が変化)。
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("取除前="+fruits.inspect()+"<br>"); var shift_fruit=fruits.shift(); document.write("結果="+shift_fruit+"<br>"); document.write("取除後="+fruits.inspect()+"<br><br>"); var fruits2=[ ["apple", "200"], ["orange", "500"], ["remon", "80"], ["grape", "1000"] ]; document.write("取除前="+fruits2.inspect()+"<br>"); var shift_fruit=fruits2.shift(); document.write("結果="+shift_fruit.inspect()+"<br>"); document.write("取除後="+fruits2.inspect()+"<br><br>"); </script>
配列をフラット配列に変換
flatten()
unknown
対象となる配列オブジェクト.flatten(); → newArray
サンプルを見る<script type="text/javascript"> var fruits2=[ ["apple", "200"], ["orange", "500"], ["remon", "80"], ["grape", "1000"] ]; document.write("変換前の配列の長さ="+fruits2.length+"<br>"); var res_fruits2=fruits2.flatten(); document.write("変換後の配列の長さ="+res_fruits2.length+"<br>"); </script>
配列の長さを返す
length
unknown
対象となる配列オブジェクト.length; → Number
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; var fruits2=[ ["apple", "200"], ["orange", "500"], ["remon", "80"], ["grape", "1000"] ]; document.write("fuits配列の長さ: "+fruits.length+"<br>"); document.write("fruits2配列の長さ: "+fruits2.length); </script>
reduce
reduce()
unknown
対象となる配列オブジェクト.reduce(); → Array or singleValue
サンプルを見る<script type="text/javascript"> document.write([3].reduce()+"<br>"); document.write([0,1,2,3].reduce()); </script>
配列から重複する値を削除
uniq()
unknown
対象となる配列オブジェクト.uniq(); → newArray
配列から重複する値の要素を削除した新しい配列を返します(元配列に変化なし)。 大文字、小文字の区別はされません。
サンプルを見る<script type="text/javascript"> var fruits=["apple","banana","Apple","banana","pine-apple"]; document.write("削除前: "+fruits.inspect()+"<br>"); document.write("削除後: "+fruits.uniq().inspect()); </script>
配列の最初の要素、最後の要素を取得
firs()、last()
unknown
最初の要素=対象となる配列オブジェクト.first();
最後の要素=対象となる配列オブジェクト.last();
最後の要素=対象となる配列オブジェクト.last();
first()メソッドは、配列の最初の要素を返します。 last()メソッドは、配列の最後の要素を返します。 配列が空の場合など、要素を取得できない場合は、undefinedを返します。
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("最初の要素="+fruits.first()+"<br>"); document.write("最後の要素="+fruits.last()+"<br>"); </script>
配列要素を可読可能な文字列に変換
inspect()
unknown
対象となる配列オブジェクト.inspect(); → String
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("変換前="+fruits+"<br>"); document.write("変換後="+fruits.inspect()+"<br><br>"); var fruits2=[ ["apple", "200"], ["orange", "500"], ["remon", "80"], ["grape", "1000"] ]; document.write("変換前="+fruits2+"<br>"); document.write("変換後="+fruits2.inspect()+"<br><br>"); </script>
配列をJSON形式に変換
toJSON()
unknown
対象となる配列オブジェクト.toJSON(); → String
配列をJSON形式のデータに変換し、文字列として返します。
サンプルを見る<script type="text/javascript"> var ary=[100, "apple", null, {id: 001, name: "john", age: 30}]; document.write("変換前: "+ary.inspect()+"<br>"); document.write("変換後: "+ary.toJSON().inspect()); </script>
配列要素を検索
indexOf()
unknown
対象となる配列オブジェクト.indexOf(value); → position
指定した値を検索し、見つかった要素の配列における位置を数値で返します。 配列の先頭の要素の場合は、0が返ります。 見つからない場合は、-1を返します。
第1引数valueには、検索する値を指定します。
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("appleが見つかった要素位置="+fruits.indexOf("apple")+"<br>"); document.write("grapeが見つかった要素位置="+fruits.indexOf("grape")+"<br>"); </script>
値がnull、undefinedの要素を削除
compact()
unknown
対象となる配列オブジェクト.compact(); → newArray
配列から、値がnull、undefinedの要素を削除した新しい配列を返します(元配列に変化なし)。
サンプルを見る<script type="text/javascript"> var drinks=[]; drinks[1]="coffee"; drinks[3]=null; drinks[5]="milk" drinks[8]="juice"; document.write("削除前="+drinks.toString()+"<br>"); var res_drinks=drinks.compact(); document.write("削除後="+res_drinks.toString()+"<br>"); </script>
配列要素を逆順に並び替え
reverse()
unknown
対象となる配列オブジェクト.reverse([inline=true]); → Array
サンプルを見る<script type="text/javascript"> var fruits=["apple","orange","remon","banana","grape"]; document.write("変換前="+fruits.inspect()+"<br>"); document.write("変換後="+fruits.reverse().inspect()+"<br><br>"); var fruits2=[ ["apple", "200"], ["orange", "500"], ["remon", "80"], ["grape", "1000"] ]; document.write("変換前="+fruits2.inspect()+"<br>"); document.write("変換後="+fruits2.reverse().inspect()+"<br><br>"); </script>