diff options
Diffstat (limited to 'files/ja/web/javascript/reference/global_objects/array/reverse/index.html')
-rw-r--r-- | files/ja/web/javascript/reference/global_objects/array/reverse/index.html | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/files/ja/web/javascript/reference/global_objects/array/reverse/index.html b/files/ja/web/javascript/reference/global_objects/array/reverse/index.html new file mode 100644 index 0000000000..4ff1fd367c --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/array/reverse/index.html @@ -0,0 +1,91 @@ +--- +title: Array.prototype.reverse() +slug: Web/JavaScript/Reference/Global_Objects/Array/reverse +tags: + - Array + - JavaScript + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Array/reverse +--- +<div>{{JSRef}}</div> + +<p><strong><code>reverse()</code></strong> メソッドは、配列の要素を <em><a href="https://ja.wikipedia.org/wiki/In-place%E3%82%A2%E3%83%AB%E3%82%B4%E3%83%AA%E3%82%BA%E3%83%A0">In-place アルゴリズム</a></em>で反転させます。最初の要素が最後の要素に、最後の要素が最初の要素になります。</p> + +<div>{{EmbedInteractiveExample("pages/js/array-reverse.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>a</var>.reverse()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>反転した配列です。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>reverse</code> メソッドは、呼び出した配列オブジェクトの要素を反転し、書き換えられた配列の参照を返します。</p> + +<p><code>reverse</code> は意図的に汎用性を持たせています。つまり、このメソッドは配列に類似したオブジェクトに対して{{jsxref("Function.call", "呼び出し", "", 1)}}たり、{{jsxref("Function.apply", "適用し", "", 1)}}たりすることもできます。ゼロから始まる数値プロパティであり、連続した連なりの最後を反映している <code>length</code> プロパティを含まないオブジェクトでは効果がないかもしれません。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Reversing_the_elements_in_an_array" name="Reversing_the_elements_in_an_array">配列の要素を反転させる</h3> + +<p>次の例は、3 つの要素を含む配列 <code>a</code> を作成し、その配列を反転させます。<code>reverse()</code> の呼び出しは、反転した配列 <code>a</code> への参照を返します。</p> + +<pre class="brush: js notranslate">const a = [1, 2, 3]; + +console.log(a); // [1, 2, 3] + +a.reverse(); + +console.log(a); // [3, 2, 1] + +</pre> + +<h3 id="Reversing_the_elements_in_an_array-like_object" name="Reversing_the_elements_in_an_array-like_object">配列状オブジェクトの要素を反転させる</h3> + +<p>次の例は、3 つの要素と length プロパティを含む配列状オブジェクト <code>a</code> を作成し、その配列状オブジェクトを反転させます。<code>reverse()</code> の呼び出しは、反転した配列状オブジェクト <code>a</code> への参照を返します。</p> + +<pre class="brush: js notranslate">const a = {0: 1, 1: 2, 2: 3, length: 3}; + +console.log(a); // {0: 1, 1: 2, 2: 3, length: 3} + +Array.prototype.reverse.call(a); //apply() を使用するのと同じ構文 + +console.log(a); // {0: 3, 1: 2, 2: 1, length: 3} +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-array.prototype.reverse', 'Array.prototype.reverse')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Array.reverse")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Array.prototype.join()")}}</li> + <li>{{jsxref("Array.prototype.sort()")}}</li> + <li>{{jsxref("TypedArray.prototype.reverse()")}}</li> +</ul> |