diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2021-09-15 22:55:04 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-09-15 22:55:04 +0900 |
commit | 33c66e7c7a3352866f217e0ace0207d9a17fc125 (patch) | |
tree | 115fb7ceb76de1dcb4867ab40782909d3fa0a5a4 /files/ja | |
parent | 6fc11bde75d256b6ce60ff1d518a2ec1b4e05cb5 (diff) | |
download | translated-content-33c66e7c7a3352866f217e0ace0207d9a17fc125.tar.gz translated-content-33c66e7c7a3352866f217e0ace0207d9a17fc125.tar.bz2 translated-content-33c66e7c7a3352866f217e0ace0207d9a17fc125.zip |
型付き配列のクラスリファレンスを更新 (#2372)
- Markdownに変換
- 2021/09/06時点の英語版に同期
Diffstat (limited to 'files/ja')
21 files changed, 1613 insertions, 1697 deletions
diff --git a/files/ja/web/javascript/reference/global_objects/bigint64array/index.html b/files/ja/web/javascript/reference/global_objects/bigint64array/index.html deleted file mode 100644 index db7a3ac87f..0000000000 --- a/files/ja/web/javascript/reference/global_objects/bigint64array/index.html +++ /dev/null @@ -1,170 +0,0 @@ ---- -title: BigInt64Array -slug: Web/JavaScript/Reference/Global_Objects/BigInt64Array -tags: - - BigInt - - BigInt64Array - - Class - - JavaScript - - Reference - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/BigInt64Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>BigInt64Array</code></strong> 型の配列は、プラットフォームのバイト順で 64 ビット符号付き整数の配列を表します。バイト順を制御する必要がある場合は、代わりに {{jsxref("DataView")}} を使用してください。内容は <code>0n</code> に初期化されます。一度確立されると、オブジェクトのメソッドを使って配列内の要素を参照するか、標準の配列インデックス構文を使って(つまり、角括弧記法を使って)配列を参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt><a href="/docs/Web/JavaScript/Reference/Global_Objects/BigInt64Array/BigInt64Array"><code>BigInt64Array()</code></a></dt> - <dd>新しい <code>BigInt64Array</code> オブジェクトを作成します</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "BigInt64Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素サイズの数値を返します。<code>BigInt64Array</code> は <code>8</code> です。</dd> - <dt>{{jsxref("TypedArray.name", "BigInt64Array.name")}}</dt> - <dd>コンストラクター名の文字列を返します。<code>BigInt64Array</code> は "BigInt64Array" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "BigInt64Array.from()")}}</dt> - <dd>array-like、あるいは iterable オブジェクトから新しい <code>BigInt64Array</code> を作成します。{{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "BigInt64Array.of()")}}</dt> - <dd>可変数の引数から新しい <code>BigInt64Array</code> を作成します。{{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "BigInt64Array.prototype.buffer")}}</dt> - <dd><code>BigInt64Array</code> が参照する {{jsxref("ArrayBuffer")}} を返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "BigInt64Array.prototype.byteLength")}}</dt> - <dd><code>BigInt64Array</code> の {{jsxref("ArrayBuffer")}} の先頭からの長さをバイト数で返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "BigInt64Array.prototype.byteOffset")}}</dt> - <dd><code>BigInt64Array</code> の {{jsxref("ArrayBuffer")}} の先頭からのオフセットをバイト単位で返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "BigInt64Array.prototype.length")}}</dt> - <dd><code>BigInt64Array</code> に保持されている要素数を返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "BigInt64Array.prototype.copyWithin()")}}</dt> - <dd>配列内の配列要素のシーケンスをコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "BigInt64Array.prototype.entries()")}}</dt> - <dd>配列の各インデックスのキーと値のペアを含む、新しい <code>Array Iterator</code> オブジェクトを返します。{{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "BigInt64Array.prototype.every()")}}</dt> - <dd>配列のすべての要素が、関数で指定されたテストに合格するかどうかをテストします。{{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "BigInt64Array.prototype.fill()")}}</dt> - <dd>開始インデックスから終了インデックスまでの、配列のすべての要素を静的な値で埋めます。{{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "BigInt64Array.prototype.filter()")}}</dt> - <dd>指定したフィルターリング関数が <code>true</code> を返す要素をすべて含む、新しい配列を作成します。{{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "BigInt64Array.prototype.find()")}}</dt> - <dd>配列内の要素が指定したテスト関数を満たしている場合は、配列内で見つかった値を返し、見つからなかった場合は <code>undefined</code> を返します。{{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "BigInt64Array.prototype.findIndex()")}}</dt> - <dd>配列内の要素が指定したテスト関数を満たす場合は、配列内で見つかったインデックスを返し、見つからなかった場合は -1 を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "BigInt64Array.prototype.forEach()")}}</dt> - <dd>配列の各要素に対して関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "BigInt64Array.prototype.includes()")}}</dt> - <dd>型付き配列が特定の要素を含むかどうかを判断し、適切な場合は <code>true</code> または <code>false</code> を返します。{{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "BigInt64Array.prototype.indexOf()")}}</dt> - <dd>指定した値と等しい配列内の要素の最初の(最小の)インデックスを返します。何も見つからない場合は -1 を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "BigInt64Array.prototype.join()")}}</dt> - <dd>配列のすべての要素を文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "BigInt64Array.prototype.keys()")}}</dt> - <dd>配列の各インデックスのキーを含む新しい <code>Array Iterator</code> を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "BigInt64Array.prototype.lastIndexOf()")}}</dt> - <dd>指定した値と等しい配列内の要素の最後の(最大の)インデックスを返します。何も見つからない場合は -1 を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "BigInt64Array.prototype.map()")}}</dt> - <dd>この配列の各要素に対して指定した関数を呼び出した結果を持つ、新しい配列を作成します。{{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "BigInt64Array.prototype.reduce()")}}</dt> - <dd>アキュムレータと配列の各値(左から右へ)を一つの値に減らすための関数を適用します。{{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "BigInt64Array.prototype.reduceRight()")}}</dt> - <dd>アキュムレータと配列の各値(右から左へ)を一つの値に減らすための関数を適用します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "BigInt64Array.prototype.reverse()")}}</dt> - <dd>配列の要素の順序を反転させます — 最初が最後になり、最後が最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "BigInt64Array.prototype.set()")}}</dt> - <dd>型付けされた配列に複数の値を格納し、指定した配列から入力値を読み込みます。</dd> - <dt>{{jsxref("TypedArray.slice", "BigInt64Array.prototype.slice()")}}</dt> - <dd>配列の一部を抽出し、新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "BigInt64Array.prototype.some()")}}</dt> - <dd>配列の少なくとも一つの要素が、指定したテスト関数を満たしている場合に <code>true</code> を返します。{{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "BigInt64Array.prototype.sort()")}}</dt> - <dd>配列の要素を所定の位置に並べ替えて、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "BigInt64Array.prototype.subarray()")}}</dt> - <dd>指定した開始要素と終了要素のインデックスから、新しい <code>BigUint64Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "BigInt64Array.prototype.values()")}}</dt> - <dd>配列の各インデックスの値を含む、新しい <code>Array Iterator</code> オブジェクトを返します。{{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "BigInt64Array.prototype.toLocaleString()")}}</dt> - <dd>配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "BigInt64Array.prototype.toString()")}}</dt> - <dd>配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "BigInt64Array.prototype[@@iterator]()")}}</dt> - <dd>配列の各インデックスの値を含む、新しい <code>Array Iterator</code> オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_a_BigInt64Array" name="Different_ways_to_create_a_BigInt64Array"><code>BigInt64Array</code> の作成方法の違い</h3> - -<pre class="brush: js notranslate">// length から -var bigint64 = new BigInt64Array(2); -bigint64[0] = 42n; -console.log(bigint64[0]); // 42n -console.log(bigint64.length); // 2 -console.log(bigint64.BYTES_PER_ELEMENT); // 8 - -// 配列から -var arr = new BigInt64Array([21n,31n]); -console.log(arr[1]); // 31n - -// 別の TypedArray から -var x = new BigInt64Array([21n, 31n]); -var y = new BigInt64Array(x); -console.log(y[0]); // 21n - -// ArrayBuffer から -var buffer = new ArrayBuffer(32); -var z = new BigInt64Array(buffer, 0, 4); - -// iterable なものから -var iterable = function*(){ yield* [1n, 2n, 3n]; }(); -var bigint64 = new BigInt64Array(iterable); -// BigInt64Array[1n, 2n, 3n] -</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-typedarray-objects", "BigInt64Array")}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - - - -<p>{{Compat("javascript.builtins.BigInt64Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/docs/Web/JavaScript/Typed_arrays" title="en/JavaScript typed arrays">JavaScript typed arrays</a></li> - <li>{{jsxref("BigUint64Array")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/bigint64array/index.md b/files/ja/web/javascript/reference/global_objects/bigint64array/index.md new file mode 100644 index 0000000000..b874e53d62 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/bigint64array/index.md @@ -0,0 +1,147 @@ +--- +title: BigInt64Array +slug: Web/JavaScript/Reference/Global_Objects/BigInt64Array +tags: + - BigInt + - BigInt64Array + - クラス + - JavaScript + - Reference + - TypedArray + - 型付き配列 +browser-compat: javascript.builtins.BigInt64Array +translation_of: Web/JavaScript/Reference/Global_Objects/BigInt64Array +--- +{{JSRef}} + +**`BigInt64Array`** は型付き配列で、プラットフォームのバイト順による 16 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0n` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- [`BigInt64Array()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/BigInt64Array/BigInt64Array) + - : 新しい `BigInt64Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "BigInt64Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`BigInt64Array` の場合は `8` です。 +- {{jsxref("TypedArray.name", "BigInt64Array.name")}} + - : コンストラクター名を文字列値で返します。`BigInt64Array` の場合、 "`BigInt64Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "BigInt64Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `BigInt64Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "BigInt64Array.of()")}} + - : 可変長引数で新しい `BigInt64Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "BigInt64Array.prototype.buffer")}} + - : `BigInt64Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "BigInt64Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `BigInt64Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "BigInt64Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `BigInt64Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "BigInt64Array.prototype.length")}} + - : `BigInt64Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "BigInt64Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "BigInt64Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "BigInt64Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "BigInt64Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "BigInt64Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "BigInt64Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "BigInt64Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "BigInt64Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "BigInt64Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "BigInt64Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "BigInt64Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "BigInt64Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "BigInt64Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "BigInt64Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "BigInt64Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "BigInt64Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "BigInt64Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "BigInt64Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "BigInt64Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "BigInt64Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "BigInt64Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "BigInt64Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `BigInt64Array` を返します。 +- {{jsxref("TypedArray.values", "BigInt64Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "BigInt64Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "BigInt64Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "BigInt64Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `BigInt64Array` を作成 + +```js +// 長さから +var bigint64 = new BigInt64Array(2); +bigint64[0] = 42n; +console.log(bigint64[0]); // 42n +console.log(bigint64.length); // 2 +console.log(bigint64.BYTES_PER_ELEMENT); // 8 + +// 配列から +var arr = new BigInt64Array([21n,31n]); +console.log(arr[1]); // 31n + +// From another TypedArray +var x = new BigInt64Array([21n, 31n]); +var y = new BigInt64Array(x); +console.log(y[0]); // 21n + +// ArrayBuffer から +var buffer = new ArrayBuffer(32); +var z = new BigInt64Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1n, 2n, 3n]; }(); +var bigint64 = new BigInt64Array(iterable); +// BigInt64Array[1n, 2n, 3n] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("BigUint64Array")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/biguint64array/index.html b/files/ja/web/javascript/reference/global_objects/biguint64array/index.html deleted file mode 100644 index 0976191b2c..0000000000 --- a/files/ja/web/javascript/reference/global_objects/biguint64array/index.html +++ /dev/null @@ -1,170 +0,0 @@ ---- -title: BigUint64Array -slug: Web/JavaScript/Reference/Global_Objects/BigUint64Array -tags: - - BigInt - - BigUInt64Array - - Class - - JavaScript - - Reference - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/BigUint64Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>BigUint64Array</code></strong> 型の配列は、プラットフォームのバイト順で 64 ビット符号付き整数の配列を表します。バイト順を制御する必要がある場合は、代わりに {{jsxref("DataView")}} を使用してください。内容は <code>0n</code> に初期化されます。一度確立されると、オブジェクトのメソッドを使って配列内の要素を参照するか、標準の配列インデックス構文を使って(つまり、角括弧記法を使って)配列を参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt><a href="/docs/Web/JavaScript/Reference/Global_Objects/BigUint64Array/BigUint64Array"><code>BigUint64Array()</code></a></dt> - <dd>新しい <code>BigUint64Array</code> オブジェクトを作成します</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "BigUint64Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素サイズの数値を返します。<code>BigUint64Array</code> は <code>8</code> です。</dd> - <dt>{{jsxref("TypedArray.name", "BigUint64Array.name")}}</dt> - <dd>コンストラクター名の文字列を返します。<code>BigUint64Array</code> は "BigUint64Array" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "BigUint64Array.from()")}}</dt> - <dd>array-like、あるいは iterable オブジェクトから新しい <code>BigUint64Array</code> を作成します。{{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "BigUint64Array.of()")}}</dt> - <dd>可変数の引数から新しい <code>BigUint64Array</code> を作成します。{{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "BigUint64Array.prototype.buffer")}}</dt> - <dd><code>BigUint64Array</code> が参照する {{jsxref("ArrayBuffer")}} を返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "BigUint64Array.prototype.byteLength")}}</dt> - <dd><code>BigUint64Array</code> の {{jsxref("ArrayBuffer")}} の先頭からの長さをバイト数で返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "BigUint64Array.prototype.byteOffset")}}</dt> - <dd><code>BigUint64Array</code> の {{jsxref("ArrayBuffer")}} の先頭からのオフセットをバイト単位で返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "BigUint64Array.prototype.length")}}</dt> - <dd><code>BigUint64Array</code> に保持されている要素数を返します。これは構築時に固定されているため、<strong>読み取り専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "BigUint64Array.prototype.copyWithin()")}}</dt> - <dd>配列内の配列要素のシーケンスをコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "BigUint64Array.prototype.entries()")}}</dt> - <dd>配列の各インデックスのキーと値のペアを含む、新しい <code>Array Iterator</code> オブジェクトを返します。{{jsxref("Array.prototype.entry()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "BigUint64Array.prototype.every()")}}</dt> - <dd>配列のすべての要素が、関数で指定されたテストに合格するかどうかをテストします。{{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "BigUint64Array.prototype.fill()")}}</dt> - <dd>開始インデックスから終了インデックスまでの、配列のすべての要素を静的な値で埋めます。{{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "BigUint64Array.prototype.filter()")}}</dt> - <dd>指定したフィルターリング関数が <code>true</code> を返す要素をすべて含む、新しい配列を作成します。{{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "BigUint64Array.prototype.find()")}}</dt> - <dd>配列内の要素が指定したテスト関数を満たしている場合は、配列内で見つかった値を返し、見つからなかった場合は <code>undefined</code> を返します。{{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "BigUint64Array.prototype.findIndex()")}}</dt> - <dd>配列内の要素が指定したテスト関数を満たす場合は、配列内で見つかったインデックスを返し、見つからなかった場合は -1 を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "BigUint64Array.prototype.forEach()")}}</dt> - <dd>配列の各要素に対して関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "BigUint64Array.prototype.includes()")}}</dt> - <dd>型付き配列が特定の要素を含むかどうかを判断し、適切な場合は <code>true</code> または <code>false</code> を返します。{{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "BigUint64Array.prototype.indexOf()")}}</dt> - <dd>指定した値と等しい配列内の要素の最初の(最小の)インデックスを返します。何も見つからない場合は -1 を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "BigUint64Array.prototype.join()")}}</dt> - <dd>配列のすべての要素を文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "BigUint64Array.prototype.keys()")}}</dt> - <dd>配列の各インデックスのキーを含む新しい <code>Array Iterator</code> を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "BigUint64Array.prototype.lastIndexOf()")}}</dt> - <dd>指定した値と等しい配列内の要素の最後の(最大の)インデックスを返します。何も見つからない場合は -1 を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "BigUint64Array.prototype.map()")}}</dt> - <dd>この配列の各要素に対して指定した関数を呼び出した結果を持つ、新しい配列を作成します。{{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "BigUint64Array.prototype.reduce()")}}</dt> - <dd>アキュムレータと配列の各値(左から右へ)を一つの値に減らすための関数を適用します。{{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "BigUint64Array.prototype.reduceRight()")}}</dt> - <dd>アキュムレータと配列の各値(右から左へ)を一つの値に減らすための関数を適用します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "BigUint64Array.prototype.reverse()")}}</dt> - <dd>配列の要素の順序を反転させます — 最初が最後になり、最後が最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "BigUint64Array.prototype.set()")}}</dt> - <dd>型付けされた配列に複数の値を格納し、指定した配列から入力値を読み込みます。</dd> - <dt>{{jsxref("TypedArray.slice", "BigUint64Array.prototype.slice()")}}</dt> - <dd>配列の一部を抽出し、新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "BigUint64Array.prototype.some()")}}</dt> - <dd>配列の少なくとも一つの要素が、指定したテスト関数を満たしている場合に <code>true</code> を返します。{{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "BigUint64Array.prototype.sort()")}}</dt> - <dd>配列の要素を所定の位置に並べ替えて、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "BigUint64Array.prototype.subarray()")}}</dt> - <dd>指定した開始要素と終了要素のインデックスから、新しい <code>BigUint64Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "BigUint64Array.prototype.values()")}}</dt> - <dd>配列の各インデックスの値を含む、新しい <code>Array Iterator</code> オブジェクトを返します。{{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "BigUint64Array.prototype.toLocaleString()")}}</dt> - <dd>配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "BigUint64Array.prototype.toString()")}}</dt> - <dd>配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "BigUint64Array.prototype[@@iterator]()")}}</dt> - <dd>配列の各インデックスの値を含む、新しい <code>Array Iterator</code> オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_a_BigUint64Array" name="Different_ways_to_create_a_BigUint64Array"><code>BigUint64Array</code> の作成方法の違い</h3> - -<pre class="brush: js notranslate">// length から -var biguint64 = new BigUint64Array(2); -biguint64[0] = 42n; -console.log(biguint64[0]); // 42n -console.log(biguint64.length); // 2 -console.log(biguint64.BYTES_PER_ELEMENT); // 8 - -// 配列から -var arr = new BigUint64Array([21n,31n]); -console.log(arr[1]); // 31n - -// 別の TypedArray から -var x = new BigUint64Array([21n, 31n]); -var y = new BigUint64Array(x); -console.log(y[0]); // 21n - -// ArrayBuffer から -var buffer = new ArrayBuffer(32); -var z = new BigUint64Array(buffer, 0, 4); - -// iterable なものから -var iterable = function*(){ yield* [1n, 2n, 3n]; }(); -var biguint64 = new BigUint64Array(iterable); -// BigUint64Array[1n, 2n, 3n] -</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-typedarray-objects", "BigUint64Array")}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - - - -<p>{{Compat("javascript.builtins.BigUint64Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/docs/Web/JavaScript/Typed_arrays" title="en/JavaScript typed arrays">JavaScript typed arrays</a></li> - <li>{{jsxref("BigInt64Array")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/biguint64array/index.md b/files/ja/web/javascript/reference/global_objects/biguint64array/index.md new file mode 100644 index 0000000000..9b8fd47ba8 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/biguint64array/index.md @@ -0,0 +1,147 @@ +--- +title: BigUint64Array +slug: Web/JavaScript/Reference/Global_Objects/BigUint64Array +tags: + - BigInt + - BigUInt64Array + - クラス + - JavaScript + - Reference + - TypedArray + - 型付き配列 +browser-compat: javascript.builtins.BigUint64Array +translation_of: Web/JavaScript/Reference/Global_Objects/BigUint64Array +--- +{{JSRef}} + +**`BigUint64Array`** は型付き配列で、プラットフォームのバイト順による 16 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0n` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- [`BigUint64Array()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/BigUint64Array/BigUint64Array) + - : 新しい `BigUint64Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "BigUint64Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`BigUint64Array` の場合は `8` です。 +- {{jsxref("TypedArray.name", "BigUint64Array.name")}} + - : コンストラクター名を文字列値で返します。`BigUint64Array` の場合、 "`BigUint64Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "BigUint64Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `BigUint64Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "BigUint64Array.of()")}} + - : 可変長引数で新しい `BigUint64Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "BigUint64Array.prototype.buffer")}} + - : `BigUint64Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "BigUint64Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `BigUint64Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "BigUint64Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `BigUint64Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "BigUint64Array.prototype.length")}} + - : `BigUint64Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "BigUint64Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "BigUint64Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "BigUint64Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "BigUint64Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "BigUint64Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "BigUint64Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "BigUint64Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "BigUint64Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "BigUint64Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "BigUint64Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "BigUint64Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "BigUint64Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "BigUint64Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "BigUint64Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "BigUint64Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "BigUint64Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "BigUint64Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "BigUint64Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "BigUint64Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "BigUint64Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "BigUint64Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "BigUint64Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `BigUint64Array` を返します。 +- {{jsxref("TypedArray.values", "BigUint64Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "BigUint64Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "BigUint64Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "BigUint64Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `BigUint64Array` を作成 + +```js +// 長さから +var biguint64 = new BigUint64Array(2); +biguint64[0] = 42n; +console.log(biguint64[0]); // 42n +console.log(biguint64.length); // 2 +console.log(biguint64.BYTES_PER_ELEMENT); // 8 + +// 配列から +var arr = new BigUint64Array([21n,31n]); +console.log(arr[1]); // 31n + +// From another TypedArray +var x = new BigUint64Array([21n, 31n]); +var y = new BigUint64Array(x); +console.log(y[0]); // 21n + +// ArrayBuffer から +var buffer = new ArrayBuffer(32); +var z = new BigUint64Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1n, 2n, 3n]; }(); +var biguint64 = new BigUint64Array(iterable); +// BigUint64Array[1n, 2n, 3n] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("BigInt64Array")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/float32array/index.html b/files/ja/web/javascript/reference/global_objects/float32array/index.html deleted file mode 100644 index 16256ccb1e..0000000000 --- a/files/ja/web/javascript/reference/global_objects/float32array/index.html +++ /dev/null @@ -1,197 +0,0 @@ ---- -title: Float32Array -slug: Web/JavaScript/Reference/Global_Objects/Float32Array -tags: - - Constructor - - JavaScript - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/Float32Array ---- -<div>{{JSRef}}</div> - -<p><code>Float32Array タイプは、32 ビット浮動小数点数 (C 言語の float データタイプに相当します) の配列を表します。</code>各要素のバイトオーダーはプラットフォームに依存します。もしコントロールしたい場合は代わりに{{jsxref("DataView")}}を使って下さい。各要素は0で初期化されます。生成された <code>Float32Array</code> オブジェクトのメソッドあるいは配列のような表記法 ("<code>[]</code>") を用いて、要素を参照することができます。</p> - -<h2 id="Constructors" name="Constructors">構文</h2> - -<pre class="syntaxbox">new Float32Array(); // new in ES2017 -new Float32Array(length); -new Float32Array(typedArray); -new Float32Array(object); -new Float32Array(buffer [, byteOffset [, length]]);</pre> - -<p>コンストラクタの構文とパラメータについての詳しい情報は{{jsxref("TypedArray")}}を参照して下さい。</p> - -<h2 id="プロパティ">プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Float32Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素一個あたりのバイト数を返します。<code>Float32Array</code> の場合は<font face="Consolas, Liberation Mono, Courier, monospace">4</font>です。</dd> - <dt>Float32Array.length</dt> - <dd><code>値は3になります</code>。実際の長さ(要素数)については{{jsxref("TypedArray.prototype.length", "Float32Array.prototype.length")}}を参照して下さい。</dd> - <dt>{{jsxref("TypedArray.name", "Float32Array.name")}}</dt> - <dd>コンストラクタ名を文字列値で返します。<code>Float32Array</code> の場合、"Float32Array"<code>です</code>。</dd> - <dt>{{jsxref("TypedArray.prototype", "Float32Array.prototype")}}</dt> - <dd><em>TypedArray</em> オブジェクトのプロトタイプです。</dd> -</dl> - -<h2 id="メソッド">メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Float32Array.from()")}}</dt> - <dd>配列状のオブジェクトやイテレート可能なオブジェクトから、新たな <code>Float32Array</code> オブジェクトを生成します。{{jsxref("Array.from()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.of", "Float32Array.of()")}}</dt> - <dd>可変長引数で新しい <code>Float32Array</code> オブジェクトを生成します。{{jsxref("Array.of()")}}も確かめて下さい。</dd> -</dl> - -<h2 id="Float32Array_プロトタイプ"><code>Float32Array</code> プロトタイプ</h2> - -<p>全ての <code>Float32Array</code> オブジェクトは {{jsxref("TypedArray.prototype", "%TypedArray%.prototype")}} を継承しています。</p> - -<h3 id="プロパティ_2">プロパティ</h3> - -<dl> - <dt><code>Float32Array.prototype.constructor</code></dt> - <dd>インスタンスのプロトタイプを作る関数を返します。これは、デフォルトで対応する <code>Float32Array</code> コンストラクタです。</dd> - <dt>{{jsxref("TypedArray.prototype.buffer", "Float32Array.prototype.buffer")}} {{readonlyInline}}</dt> - <dd><code>Float32Array</code> オブジェクトによって参照される{{jsxref("ArrayBuffer")}}を返します。構築時に設定され、<strong>読取専用</strong>となります。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Float32Array.prototype.byteLength")}} {{readonlyInline}}</dt> - <dd>{{jsxref("ArrayBuffer")}}の開始位置からの<code>Float32Array</code> オブジェクトの(バイト単位の)長さを返します。構築時に設定され、<strong>読取専用</strong>となります。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Float32Array.prototype.byteOffset")}} {{readonlyInline}}</dt> - <dd>{{jsxref("ArrayBuffer")}}の開始位置からの<code>Float32Array</code> オブジェクトの(バイト単位の)オフセットを返します。構築時に設定され、<strong>読取専用</strong>となります。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Float32Array.prototype.length")}} {{readonlyInline}}</dt> - <dd><code>Float32Array</code> オブジェクト内に保持された要素の数を返します。構築時に設定され、<strong>読取専用</strong>となります。</dd> - <dt> - <h3 id="メソッド_2">メソッド</h3> - </dt> - <dt>{{jsxref("TypedArray.prototype.copyWithin()", "Float32Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.entries", "Float32Array.prototype.entries()")}}</dt> - <dd>配列内で各インデックスに対して、キー/バリュー ペアを含む新しい<code>Array Iterator</code>を返します。{{jsxref("Array.prototype.entries()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.every", "Float32Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.fill", "Float32Array.prototype.fill()")}}</dt> - <dd>開始位置から終了位置までの配列のすべての要素を固定値で設定します。{{jsxref("Array.prototype.fill()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.filter", "Float32Array.prototype.filter()")}}</dt> - <dd>与えられたフィルタリング関数がtrueを返す配列のすべての要素をもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.find", "Float32Array.prototype.find()")}}</dt> - <dd>配列要素が与えられたテスト関数を満足したら、配列の値を返します。満足しなかった場合、<code>undefined</code>を返します。 {{jsxref("Array.prototype.find()")}}を確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Float32Array.prototype.findIndex()")}}</dt> - <dd>配列要素が与えられたテスト関数を満足したら、配列のインデックスを返します。満足しなかった場合、-1を返します。{{jsxref("Array.prototype.findIndex()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.forEach", "Float32Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対する関数を呼び出します。{{jsxref("Array.prototype.forEach()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.includes", "Float32Array.prototype.includes()")}} {{experimental_inline}}</dt> - <dd>typed arrayがある要素を含むかどうか判断し、それに応じて、<code>true</code> か <code>false</code>を返します。 {{jsxref("Array.prototype.includes()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Float32Array.prototype.indexOf()")}}</dt> - <dd>指定された値に等しい配列内の要素の最初のインデックスを返します。見つからない場合、-1を返します。{{jsxref("Array.prototype.indexOf()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.join", "Float32Array.prototype.join()")}}</dt> - <dd>すべての配列要素を文字列に結合します。{{jsxref("Array.prototype.join()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.keys", "Float32Array.prototype.keys()")}}</dt> - <dd>配列内の各インデックスに対するキーを含む新しい<code>Array Iterator</code>を返します。{{jsxref("Array.prototype.keys()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Float32Array.prototype.lastIndexOf()")}}</dt> - <dd>指定された値と等しい配列の要素の最後のインデックスを返します。見つからない場合、-1を返します。{{jsxref("Array.prototype.lastIndexOf()")}}を確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.map", "Float32Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.reduce", "Float32Array.prototype.reduce()")}}</dt> - <dd>アキュムレータに対して関数を適用し、隣り合う二つのtyped arrayの要素(左から右へ)は単一の値になります。{{jsxref("Array.prototype.reduce()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Float32Array.prototype.reduceRight()")}}</dt> - <dd>アキュムレータに対して関数を適用し、隣り合う二つのtyped arrayの要素(右から左へ)は単一の値になります。{{jsxref("Array.prototype.reduceRight()")}}を確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.reverse", "Float32Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。— 最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.set", "Float32Array.prototype.set()")}}</dt> - <dd>入力値を指定した配列から読み込み、typed array内に複数の値を格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Float32Array.prototype.slice()")}}</dt> - <dd>配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.some", "Float32Array.prototype.some()")}}</dt> - <dd>ある配列の少なくとも 1 つの要素が与えられたテスト関数を満たした場合にtrueを返します。{{jsxref("Array.prototype.some()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.sort", "Float32Array.prototype.sort()")}}</dt> - <dd>配列の要素をソートし、その結果を返します。{{jsxref("Array.prototype.sort()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.subarray", "Float32Array.prototype.subarray()")}}</dt> - <dd>与えられた開始位置と終了位置の要素インデックスの新しい<code>Float32Array</code> オブジェクトを返します。</dd> - <dt>{{jsxref("TypedArray.values", "Float32Array.prototype.values()")}}</dt> - <dd>配列内で各インデックスに対する値を含む新しい<code>Array Iterator</code>オブジェクトを返します。{{jsxref("Array.prototype.values()")}}を確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Float32Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.toString", "Float32Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}}も確かめて下さい。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Float32Array.prototype[@@iterator]()")}}</dt> - <dd>配列内で各インデックスに対する値を含む新しい<code>Array Iterator</code>オブジェクトを返します。</dd> -</dl> - -<h2 id="例">例</h2> - -<pre class="brush: js">// From a length -var float32 = new Float32Array(2); -float32[0] = 42; -console.log(float32[0]); // 42 -console.log(float32.length); // 2 -console.log(float32.BYTES_PER_ELEMENT); // 4 - -// From an array -var arr = new Float32Array([21,31]); -console.log(arr[1]); // 31 - -// From another TypedArray -var x = new Float32Array([21, 31]); -var y = new Float32Array(x); -console.log(y[0]); // 21 - -// From an ArrayBuffer -var buffer = new ArrayBuffer(16); -var z = new Float32Array(buffer, 0, 4); - -// From an iterable -var iterable = function*(){ yield* [1,2,3]; }(); -var float32 = new Float32Array(iterable); -// Float32Array[1, 2, 3]</pre> - -<h2 id="仕様">仕様</h2> - -<table class="standard-table" style="line-height: 1.5;"> - <tbody> - <tr> - <th scope="col">仕様書</th> - <th scope="col">策定状況</th> - <th scope="col">コメント</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>ECMAScript 6 で置き換えられました。</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#table-49', 'TypedArray constructors')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>ECMA 標準では最初の定義。<code>new</code> 演算子が必要なことが仕様書に含まれました。</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#table-49', 'TypedArray constructors')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2> - - - -<p>{{Compat("javascript.builtins.Float32Array")}}</p> - -<h2 id="互換性について">互換性について</h2> - -<p>ECMAScript 2015 (ES6)から、<code>Float32Array</code> コンストラクタでインスタンスを生成する場合、 {{jsxref("Operators/new", "new")}} 演算子が必要となります。 <code>Float32Array</code> を <code>new 演算子を使用せずに関数呼び出しした場合、</code>{{jsxref("TypeError")}} 例外が投げられるでしょう。</p> - -<pre class="brush: js example-bad">var dv = Float32Array([1, 2, 3]); -// TypeError: calling a builtin Float32Array constructor -// without new is forbidden</pre> - -<pre class="brush: js example-good">var dv = new Float32Array([1, 2, 3]);</pre> - -<h2 id="関連情報">関連情報</h2> - -<ul> - <li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/float32array/index.md b/files/ja/web/javascript/reference/global_objects/float32array/index.md new file mode 100644 index 0000000000..85532ba343 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/float32array/index.md @@ -0,0 +1,146 @@ +--- +title: Float32Array +slug: Web/JavaScript/Reference/Global_Objects/Float32Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Float32Array +translation_of: Web/JavaScript/Reference/Global_Objects/Float32Array +--- +{{JSRef}} + +**`Float32Array`** は型付き配列で、プラットフォームのバイト順による 32 ビット浮動小数点数 (C 言語の `float` データ型に相当) の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- [`Float32Array()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Float32Array/Float32Array) + - : 新しい `Float32Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Float32Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Float32Array` の場合は `4` です。 +- {{jsxref("TypedArray.name", "Float32Array.name")}} + - : コンストラクター名を文字列値で返します。`Float32Array` の場合、 "`Float32Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Float32Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Float32Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Float32Array.of()")}} + - : 可変長引数で新しい `Float32Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Float32Array.prototype.buffer")}} + - : `Float32Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Float32Array.prototype.byteLength")}} + - : `Float32Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Float32Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Float32Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Float32Array.prototype.length")}} + - : `Float32Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Float32Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Float32Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Float32Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Float32Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Float32Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Float32Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Float32Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Float32Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Float32Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Float32Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Float32Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Float32Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Float32Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Float32Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Float32Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Float32Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Float32Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Float32Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Float32Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Float32Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Float32Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Float32Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Float32Array` を返します。 +- {{jsxref("TypedArray.values", "Float32Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Float32Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Float32Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Float32Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Float32Array` を作成 + +```js +// 長さから +var float32 = new Float32Array(2); +float32[0] = 42; +console.log(float32[0]); // 42 +console.log(float32.length); // 2 +console.log(float32.BYTES_PER_ELEMENT); // 4 + +// 配列から +var arr = new Float32Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Float32Array([21, 31]); +var y = new Float32Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(16); +var z = new Float32Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var float32 = new Float32Array(iterable); +// Float32Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Float32Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/float64array/index.md b/files/ja/web/javascript/reference/global_objects/float64array/index.md new file mode 100644 index 0000000000..2ddc27abb8 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/float64array/index.md @@ -0,0 +1,146 @@ +--- +title: Float64Array +slug: Web/JavaScript/Reference/Global_Objects/Float64Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Float64Array +translation_of: Web/JavaScript/Reference/Global_Objects/Float64Array +--- +{{JSRef}} + +**`Float64Array`** は型付き配列で、プラットフォームのバイト順による 64 ビット浮動小数点数 (C 言語の `double` データ型に相当) の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- [`Float64Array()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Float64Array/Float64Array) + - : 新しい `Float64Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Float64Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Float64Array` の場合は `8` です。 +- {{jsxref("TypedArray.name", "Float64Array.name")}} + - : コンストラクター名を文字列値で返します。`Float64Array` の場合、 "`Float64Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Float64Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Float64Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Float64Array.of()")}} + - : 可変長引数で新しい `Float64Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Float64Array.prototype.buffer")}} + - : `Float64Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Float64Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Float64Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Float64Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Float64Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Float64Array.prototype.length")}} + - : `Float64Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Float64Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Float64Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Float64Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Float64Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Float64Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Float64Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Float64Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Float64Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Float64Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Float64Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Float64Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Float64Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Float64Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Float64Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Float64Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Float64Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Float64Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Float64Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Float64Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Float64Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Float64Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Float64Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Float64Array` を返します。 +- {{jsxref("TypedArray.values", "Float64Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Float64Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Float64Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Float64Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Float64Array` を作成 + +```js +// 長さから +var float64 = new Float64Array(2); +float64[0] = 42; +console.log(float64[0]); // 42 +console.log(float64.length); // 2 +console.log(float64.BYTES_PER_ELEMENT); // 4 + +// 配列から +var arr = new Float64Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Float64Array([21, 31]); +var y = new Float64Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(32); +var z = new Float64Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var float64 = new Float64Array(iterable); +// Float64Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Float64Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/int16array/index.html b/files/ja/web/javascript/reference/global_objects/int16array/index.html deleted file mode 100644 index 4f57724315..0000000000 --- a/files/ja/web/javascript/reference/global_objects/int16array/index.html +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: Int16Array -slug: Web/JavaScript/Reference/Global_Objects/Int16Array -tags: - - Class - - JavaScript - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/Int16Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>Int16Array</code></strong> は型付き配列であり、プラットフォームのバイト順による 2 の補数形式の 16 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Int16Array/Int16Array", "Int16Array()")}}</dt> - <dd>新しい <code>Int16Array</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int16Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Int16Array</code> の場合は <code>2</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Int16Array.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Int16Array</code> 型の場合は "<code>Int16Array</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Int16Array.from()")}}</dt> - <dd>新しい <code>Int16Array</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Int16Array.of()")}}</dt> - <dd>新しい <code>Int16Array</code> を、可変長引数で生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Int16Array.prototype.buffer")}}</dt> - <dd><code>Int16Array</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Int16Array.prototype.byteLength")}}</dt> - <dd><code>Int16Array</code> の長さを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Int16Array.prototype.byteOffset")}}</dt> - <dd><code>Int16Array</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Int16Array.prototype.length")}}</dt> - <dd><code>Int16Array</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Int16Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Int16Array.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Int16Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Int16Array.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Int16Array.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Int16Array.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Int16Array.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Int16Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Int16Array.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Int16Array.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Int16Array.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Int16Array.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Int16Array.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Int16Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Int16Array.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Int16Array.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Int16Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Int16Array.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Int16Array.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Int16Array.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Int16Array.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Int16Array.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Int16Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Int16Array.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Int16Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Int16Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Int16Array.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_an_Int16Array" name="Different_ways_to_create_an_Int16Array">Int16Array を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var int16 = new Int16Array(2); -int16[0] = 42; -console.log(int16[0]); // 42 -console.log(int16.length); // 2 -console.log(int16.BYTES_PER_ELEMENT); // 2 - -// 配列から -var arr = new Int16Array([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Int16Array([21, 31]); -var y = new Int16Array(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(8); -var z = new Int16Array(buffer, 0, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var int16 = new Int16Array(iterable); -// Int16Array[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Int16Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/int16array/index.md b/files/ja/web/javascript/reference/global_objects/int16array/index.md new file mode 100644 index 0000000000..aef0e1d4a4 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/int16array/index.md @@ -0,0 +1,146 @@ +--- +title: Int16Array +slug: Web/JavaScript/Reference/Global_Objects/Int16Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Int16Array +translation_of: Web/JavaScript/Reference/Global_Objects/Int16Array +--- +{{JSRef}} + +**`Int16Array`** は型付き配列で、プラットフォームのバイト順による 2 の補数形式の 16 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Int16Array/Int16Array", "Int16Array()")}} + - : 新しい `Int16Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int16Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Int16Array` の場合は `2` です。 +- {{jsxref("TypedArray.name", "Int16Array.name")}} + - : コンストラクター名を文字列値で返します。`Int16Array` の場合、 "Int16Array" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Int16Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Int16Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Int16Array.of()")}} + - : 可変長引数で新しい `Int16Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Int16Array.prototype.buffer")}} + - : `Int16Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Int16Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Int16Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Int16Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Int16Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Int16Array.prototype.length")}} + - : `Int16Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Int16Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Int16Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Int16Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Int16Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Int16Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Int16Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Int16Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Int16Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Int16Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Int16Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Int16Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Int16Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Int16Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Int16Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Int16Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Int16Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Int16Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Int16Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Int16Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Int16Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Int16Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Int16Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Int16Array` を返します。 +- {{jsxref("TypedArray.values", "Int16Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Int16Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Int16Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Int16Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Int16Array` を作成 + +```js +// 長さから +var int16 = new Int16Array(2); +int16[0] = 42; +console.log(int16[0]); // 42 +console.log(int16.length); // 2 +console.log(int16.BYTES_PER_ELEMENT); // 2 + +// 配列から +var arr = new Int16Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Int16Array([21, 31]); +var y = new Int16Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(8); +var z = new Int16Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var int16 = new Int16Array(iterable); +// Int16Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Int16Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/int32array/index.html b/files/ja/web/javascript/reference/global_objects/int32array/index.html deleted file mode 100644 index 9067b433dc..0000000000 --- a/files/ja/web/javascript/reference/global_objects/int32array/index.html +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: Int32Array -slug: Web/JavaScript/Reference/Global_Objects/Int32Array -tags: - - Class - - JavaScript - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/Int32Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>Int32Array</code></strong> は型付き配列であり、プラットフォームのバイト順による 2 の補数形式の 32 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Int32Array/Int32Array", "Int32Array()")}}</dt> - <dd>新しい <code>Int32Array</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int32Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Int32Array</code> の場合は <code>4</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Int32Array.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Int32Array</code> 型の場合は "<code>Int32Array</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Int32Array.from()")}}</dt> - <dd>新しい <code>Int32Array</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Int32Array.of()")}}</dt> - <dd>新しい <code>Int32Array</code> を、可変長引数で生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Int32Array.prototype.buffer")}}</dt> - <dd><code>Int32Array</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Int32Array.prototype.byteLength")}}</dt> - <dd><code>Int32Array</code> の長さを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Int32Array.prototype.byteOffset")}}</dt> - <dd><code>Int32Array</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Int32Array.prototype.length")}}</dt> - <dd><code>Int32Array</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Int32Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Int32Array.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Int32Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Int32Array.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Int32Array.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Int32Array.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Int32Array.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Int32Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Int32Array.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Int32Array.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Int32Array.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Int32Array.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Int32Array.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Int32Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Int32Array.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Int32Array.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Int32Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Int32Array.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Int32Array.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Int32Array.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Int32Array.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Int32Array.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Int32Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Int32Array.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Int32Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Int32Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Int32Array.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_an_Int32Array" name="Different_ways_to_create_an_Int32Array">Int32Array を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var int16 = new Int32Array(2); -int16[0] = 42; -console.log(int16[0]); // 42 -console.log(int16.length); // 2 -console.log(int16.BYTES_PER_ELEMENT); // 2 - -// 配列から -var arr = new Int32Array([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Int32Array([21, 31]); -var y = new Int32Array(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(16); -var z = new Int32Array(buffer, 0, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var int32 = new Int32Array(iterable); -// Int32Array[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Int32Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/int32array/index.md b/files/ja/web/javascript/reference/global_objects/int32array/index.md new file mode 100644 index 0000000000..2bbcb90905 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/int32array/index.md @@ -0,0 +1,146 @@ +--- +title: Int32Array +slug: Web/JavaScript/Reference/Global_Objects/Int32Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Int32Array +translation_of: Web/JavaScript/Reference/Global_Objects/Int32Array +--- +{{JSRef}} + +**`Int32Array`** は型付き配列で、プラットフォームのバイト順による 2 の補数形式の 16 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Int32Array/Int32Array", "Int32Array()")}} + - : 新しい `Int32Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int32Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Int32Array` の場合は `4` です。 +- {{jsxref("TypedArray.name", "Int32Array.name")}} + - : コンストラクター名を文字列値で返します。`Int32Array` の場合、 "`Int32Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Int32Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Int32Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Int32Array.of()")}} + - : 可変長引数で新しい `Int32Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Int32Array.prototype.buffer")}} + - : `Int32Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Int32Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Int32Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Int32Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Int32Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Int32Array.prototype.length")}} + - : `Int32Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Int32Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Int32Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Int32Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Int32Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Int32Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Int32Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Int32Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Int32Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Int32Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Int32Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Int32Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Int32Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Int32Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Int32Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Int32Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Int32Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Int32Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Int32Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Int32Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Int32Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Int32Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Int32Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Int32Array` を返します。 +- {{jsxref("TypedArray.values", "Int32Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Int32Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Int32Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Int32Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Int32Array` を作成 + +```js +// 長さから +var int16 = new Int32Array(2); +int16[0] = 42; +console.log(int16[0]); // 42 +console.log(int16.length); // 2 +console.log(int16.BYTES_PER_ELEMENT); // 4 + +// 配列から +var arr = new Int32Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Int32Array([21, 31]); +var y = new Int32Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(16); +var z = new Int32Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var int16 = new Int32Array(iterable); +// Int32Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Int32Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/int8array/index.html b/files/ja/web/javascript/reference/global_objects/int8array/index.html deleted file mode 100644 index 2f44432587..0000000000 --- a/files/ja/web/javascript/reference/global_objects/int8array/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: Int8Array -slug: Web/JavaScript/Reference/Global_Objects/Int8Array -tags: - - Class - - Int8Array - - JavaScript - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/Int8Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>Int8Array</code></strong> は型付き配列であり、 2 の補数形式の 8 ビット符号付き整数値の配列を表します。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Int8Array/Int8Array", "Int8Array()")}}</dt> - <dd>新しい <code>Int8Array</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int8Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Int8Array</code> の場合は <code>1</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Int8Array.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Int8Array</code> 型の場合は "<code>Int8Array</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Int8Array.from()")}}</dt> - <dd>新しい <code>Int8Array</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Int8Array.of()")}}</dt> - <dd>新しい <code>Int8Array</code> を、可変長引数で生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Int8Array.prototype.buffer")}}</dt> - <dd><code>Int8Array</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Int8Array.prototype.byteLength")}}</dt> - <dd><code>Int8Array</code> の長さを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Int8Array.prototype.byteOffset")}}</dt> - <dd><code>Int8Array</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Int8Array.prototype.length")}}</dt> - <dd><code>Int8Array</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Int8Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Int8Array.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Int8Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Int8Array.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Int8Array.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Int8Array.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Int8Array.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Int8Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Int8Array.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Int8Array.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Int8Array.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Int8Array.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Int8Array.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Int8Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Int8Array.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Int8Array.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Int8Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Int8Array.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Int8Array.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Int8Array.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Int8Array.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Int8Array.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Int8Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Int8Array.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Int8Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Int8Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Int8Array.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_an_Int8Array" name="Different_ways_to_create_an_Int8Array">Int8Array を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var int8 = new Int8Array(2); -int8[0] = 42; -console.log(int8[0]); // 42 -console.log(int8.length); // 2 -console.log(int8.BYTES_PER_ELEMENT); // 1 - -// 配列から -var arr = new Int8Array([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Int8Array([21, 31]); -var y = new Int8Array(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(8); -var z = new Int8Array(buffer, 1, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var int8 = new Int8Array(iterable); -// Int8Array[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Int8Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/int8array/index.md b/files/ja/web/javascript/reference/global_objects/int8array/index.md new file mode 100644 index 0000000000..d02659a9d8 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/int8array/index.md @@ -0,0 +1,147 @@ +--- +title: Int8Array +slug: Web/JavaScript/Reference/Global_Objects/Int8Array +tags: + - クラス + - Int8Array + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Int8Array +translation_of: Web/JavaScript/Reference/Global_Objects/Int8Array +--- +{{JSRef}} + +**`Int8Array`** は型付き配列で、 2 の補数形式の 8 ビット符号付き整数値の配列を表します。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Int8Array/Int8Array", "Int8Array()")}} + - : 新しい `Int8Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int8Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Int8Array` の場合は `1` です。 +- {{jsxref("TypedArray.name", "Int8Array.name")}} + - : コンストラクター名を文字列値で返します。`Int8Array` の場合、 "Int8Array" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Int8Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Int8Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Int8Array.of()")}} + - : 可変長引数で新しい `Int8Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Int8Array.prototype.buffer")}} + - : `Int8Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Int8Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Int8Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Int8Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Int8Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Int8Array.prototype.length")}} + - : `Int8Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Int8Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Int8Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Int8Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Int8Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Int8Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Int8Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Int8Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Int8Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Int8Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Int8Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Int8Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Int8Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Int8Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Int8Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Int8Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Int8Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Int8Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Int8Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Int8Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Int8Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Int8Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Int8Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Int8Array` を返します。 +- {{jsxref("TypedArray.values", "Int8Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Int8Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Int8Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Int8Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Int8Array` を作成 + +```js +// 長さから +var int8 = new Int8Array(2); +int8[0] = 42; +console.log(int8[0]); // 42 +console.log(int8.length); // 2 +console.log(int8.BYTES_PER_ELEMENT); // 1 + +// 配列から +var arr = new Int8Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Int8Array([21, 31]); +var y = new Int8Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(8); +var z = new Int8Array(buffer, 1, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var int8 = new Int8Array(iterable); +// Int8Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Int8Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/uint16array/index.html b/files/ja/web/javascript/reference/global_objects/uint16array/index.html deleted file mode 100644 index e85d6a886b..0000000000 --- a/files/ja/web/javascript/reference/global_objects/uint16array/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: Uint16Array -slug: Web/JavaScript/Reference/Global_Objects/Uint16Array -tags: - - Class - - JavaScript - - TypedArray - - TypedArrays - - Uint16Array -translation_of: Web/JavaScript/Reference/Global_Objects/Uint16Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>Uint16Array</code></strong> は型付き配列であり、プラットフォームのバイト順による 16 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Uint16Array/Uint16Array", "Uint16Array()")}}</dt> - <dd>新しい <code>Uint16Array</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint16Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Uint16Array</code> の場合は <code>2</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Uint16Array.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Uint16Array</code> 型の場合は "<code>Uint16Array</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Uint16Array.from()")}}</dt> - <dd>新しい <code>Uint16Array</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Uint16Array.of()")}}</dt> - <dd>新しい <code>Uint16Array</code> を、可変長引数で生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Uint16Array.prototype.buffer")}}</dt> - <dd><code>Uint16Array</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Uint16Array.prototype.byteLength")}}</dt> - <dd><code>Uint16Array</code> の長さを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Uint16Array.prototype.byteOffset")}}</dt> - <dd><code>Uint16Array</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Uint16Array.prototype.length")}}</dt> - <dd><code>Uint16Array</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Uint16Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Uint16Array.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Uint16Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Uint16Array.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Uint16Array.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Uint16Array.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Uint16Array.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Uint16Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Uint16Array.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Uint16Array.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Uint16Array.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Uint16Array.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Uint16Array.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Uint16Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Uint16Array.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Uint16Array.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Uint16Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Uint16Array.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Uint16Array.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Uint16Array.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Uint16Array.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Uint16Array.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Uint16Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Uint16Array.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Uint16Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Uint16Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Uint16Array.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_a_Uint16Array" name="Different_ways_to_create_a_Uint16Array">Uint16Array を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var uint16 = new Uint16Array(2); -uint16[0] = 42; -console.log(uint16[0]); // 42 -console.log(uint16.length); // 2 -console.log(uint16.BYTES_PER_ELEMENT); // 2 - -// 配列から -var arr = new Uint16Array([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Uint16Array([21, 31]); -var y = new Uint16Array(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(8); -var z = new Uint16Array(buffer, 0, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var uint16 = new Uint16Array(iterable); -// Uint16Array[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Uint16Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/uint16array/index.md b/files/ja/web/javascript/reference/global_objects/uint16array/index.md new file mode 100644 index 0000000000..8a9f0c6850 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/uint16array/index.md @@ -0,0 +1,147 @@ +--- +title: Uint16Array +slug: Web/JavaScript/Reference/Global_Objects/Uint16Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - Uint16Array + - ポリフィル +browser-compat: javascript.builtins.Uint16Array +translation_of: Web/JavaScript/Reference/Global_Objects/Uint16Array +--- +{{JSRef}} + +**`Uint16Array`** は型付き配列で、プラットフォームのバイト順による 16 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Uint16Array/Uint16Array", "Uint16Array()")}} + - : 新しい `Uint16Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint16Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Uint16Array` の場合は `2` です。 +- {{jsxref("TypedArray.name", "Uint16Array.name")}} + - : コンストラクター名を文字列値で返します。`Uint16Array` の場合、 "`Uint16Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Uint16Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Uint16Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Uint16Array.of()")}} + - : 可変長引数で新しい `Uint16Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Uint16Array.prototype.buffer")}} + - : `Uint16Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Uint16Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Uint16Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Uint16Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Uint16Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Uint16Array.prototype.length")}} + - : `Uint16Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Uint16Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Uint16Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Uint16Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Uint16Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Uint16Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Uint16Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Uint16Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Uint16Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Uint16Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Uint16Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Uint16Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Uint16Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Uint16Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Uint16Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Uint16Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Uint16Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Uint16Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Uint16Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Uint16Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Uint16Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Uint16Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Uint16Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Uint16Array` を返します。 +- {{jsxref("TypedArray.values", "Uint16Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Uint16Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Uint16Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Uint16Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Uint16Array` を作成 + +```js +// 長さから +var uint16 = new Uint16Array(2); +uint16[0] = 42; +console.log(uint16[0]); // 42 +console.log(uint16.length); // 2 +console.log(uint16.BYTES_PER_ELEMENT); // 2 + +// 配列から +var arr = new Uint16Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Uint16Array([21, 31]); +var y = new Uint16Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(8); +var z = new Uint16Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var uint16 = new Uint16Array(iterable); +// Uint16Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Uint16Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/uint32array/index.html b/files/ja/web/javascript/reference/global_objects/uint32array/index.html deleted file mode 100644 index a303b757d1..0000000000 --- a/files/ja/web/javascript/reference/global_objects/uint32array/index.html +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: Uint32Array -slug: Web/JavaScript/Reference/Global_Objects/Uint32Array -tags: - - Constructor - - JavaScript - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/Uint32Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>Uint32Array</code></strong> は型付き配列であり、プラットフォームのバイト順による 32 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Uint32Array/Uint32Array", "Uint32Array()")}}</dt> - <dd>新しい <code>Uint32Array</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint32Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Uint32Array</code> の場合は <code>4</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Uint32Array.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Uint32Array</code> 型の場合は "<code>Uint32Array</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Uint32Array.from()")}}</dt> - <dd>新しい <code>Uint32Array</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Uint32Array.of()")}}</dt> - <dd>新しい <code>Uint32Array</code> を、可変長引数で生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Uint32Array.prototype.buffer")}}</dt> - <dd><code>Uint32Array</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Uint32Array.prototype.byteLength")}}</dt> - <dd><code>Uint32Array</code> の長さを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Uint32Array.prototype.byteOffset")}}</dt> - <dd><code>Uint32Array</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Uint32Array.prototype.length")}}</dt> - <dd><code>Uint32Array</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Uint32Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Uint32Array.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Uint32Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Uint32Array.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Uint32Array.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Uint32Array.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Uint32Array.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Uint32Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Uint32Array.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Uint32Array.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Uint32Array.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Uint32Array.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Uint32Array.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Uint32Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Uint32Array.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Uint32Array.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Uint32Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Uint32Array.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Uint32Array.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Uint32Array.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Uint32Array.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Uint32Array.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Uint32Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Uint32Array.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Uint32Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Uint32Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Uint32Array.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_a_Uint32Array" name="Different_ways_to_create_a_Uint32Array">Uint32Array を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var int16 = new Uint32Array(2); -int16[0] = 42; -console.log(int16[0]); // 42 -console.log(int16.length); // 2 -console.log(int16.BYTES_PER_ELEMENT); // 2 - -// 配列から -var arr = new Uint32Array([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Uint32Array([21, 31]); -var y = new Uint32Array(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(16); -var z = new Uint32Array(buffer, 0, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var int32 = new Uint32Array(iterable); -// Uint32Array[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Uint32Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/uint32array/index.md b/files/ja/web/javascript/reference/global_objects/uint32array/index.md new file mode 100644 index 0000000000..df67853f2f --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/uint32array/index.md @@ -0,0 +1,147 @@ +--- +title: Uint32Array +slug: Web/JavaScript/Reference/Global_Objects/Uint32Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - Uint32Array + - ポリフィル +browser-compat: javascript.builtins.Uint32Array +translation_of: Web/JavaScript/Reference/Global_Objects/Uint32Array +--- +{{JSRef}} + +**`Uint32Array`** は型付き配列で、プラットフォームのバイト順による 32 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに {{jsxref("DataView")}} を使用してください。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Uint32Array/Uint32Array", "Uint32Array()")}} + - : 新しい `Uint32Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint32Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Uint32Array` の場合は `4` です。 +- {{jsxref("TypedArray.name", "Uint32Array.name")}} + - : コンストラクター名を文字列値で返します。`Uint32Array` の場合、 "`Uint32Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Uint32Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Uint32Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Uint32Array.of()")}} + - : 可変長引数で新しい `Uint32Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Uint32Array.prototype.buffer")}} + - : `Uint32Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Uint32Array.prototype.byteLength")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Uint32Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Uint32Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Uint32Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Uint32Array.prototype.length")}} + - : `Uint32Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Uint32Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Uint32Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Uint32Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Uint32Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Uint32Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Uint32Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Uint32Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Uint32Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Uint32Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Uint32Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Uint32Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Uint32Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Uint32Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Uint32Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Uint32Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Uint32Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Uint32Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Uint32Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Uint32Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Uint32Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Uint32Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Uint32Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Uint32Array` を返します。 +- {{jsxref("TypedArray.values", "Uint32Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Uint32Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Uint32Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Uint32Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Uint32Array` を作成 + +```js +// 長さから +var uint32 = new Uint32Array(2); +uint32[0] = 42; +console.log(uint32[0]); // 42 +console.log(uint32.length); // 2 +console.log(uint32.BYTES_PER_ELEMENT); // 4 + +// 配列から +var arr = new Uint32Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Uint32Array([21, 31]); +var y = new Uint32Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(16); +var z = new Uint32Array(buffer, 0, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var uint32 = new Uint32Array(iterable); +// Uint32Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Uint32Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/uint8array/index.html b/files/ja/web/javascript/reference/global_objects/uint8array/index.html deleted file mode 100644 index 3155f7501a..0000000000 --- a/files/ja/web/javascript/reference/global_objects/uint8array/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: Uint8Array -slug: Web/JavaScript/Reference/Global_Objects/Uint8Array -tags: - - Class - - JavaScript - - TypedArray - - TypedArrays - - Uint8Array -translation_of: Web/JavaScript/Reference/Global_Objects/Uint8Array ---- -<div>{{JSRef}}</div> - -<p><strong><code>Uint8Array</code></strong> は型付き配列であり、 8 ビット符号なし整数値の配列を表します。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Uint8Array/Uint8Array", "Uint8Array()")}}</dt> - <dd>新しい <code>Uint8Array</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint8Array.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Uint8Array</code> の場合は <code>1</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Uint8Array.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Uint8Array</code> 型の場合は "<code>Uint8Array</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Uint8Array.from()")}}</dt> - <dd>新しい <code>Uint8Array</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Uint8Array.of()")}}</dt> - <dd>新しい <code>Uint8Array</code> を、可変長引数で生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Uint8Array.prototype.buffer")}}</dt> - <dd><code>Uint8Array</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Uint8Array.prototype.byteLength")}}</dt> - <dd><code>Uint8Array</code> の長さをバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Uint8Array.prototype.byteOffset")}}</dt> - <dd><code>Uint8Array</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Uint8Array.prototype.length")}}</dt> - <dd><code>Uint8Array</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Uint8Array.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Uint8Array.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Uint8Array.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Uint8Array.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Uint8Array.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Uint8Array.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Uint8Array.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Uint8Array.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Uint8Array.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Uint8Array.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Uint8Array.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Uint8Array.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Uint8Array.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Uint8Array.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Uint8Array.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Uint8Array.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Uint8Array.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Uint8Array.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Uint8Array.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Uint8Array.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Uint8Array.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Uint8Array.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Uint8Array</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Uint8Array.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Uint8Array.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Uint8Array.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Uint8Array.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_a_Uint8Array" name="Different_ways_to_create_a_Uint8Array">Uint8Array を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var int8 = new Uint8Array(2); -int8[0] = 42; -console.log(int8[0]); // 42 -console.log(int8.length); // 2 -console.log(int8.BYTES_PER_ELEMENT); // 1 - -// 配列から -var arr = new Uint8Array([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Uint8Array([21, 31]); -var y = new Uint8Array(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(8); -var z = new Uint8Array(buffer, 1, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var uint8 = new Uint8Array(iterable); -// Uint8Array[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Uint8Array")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/uint8array/index.md b/files/ja/web/javascript/reference/global_objects/uint8array/index.md new file mode 100644 index 0000000000..469a19bdc9 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/uint8array/index.md @@ -0,0 +1,146 @@ +--- +title: Uint8Array +slug: Web/JavaScript/Reference/Global_Objects/Uint8Array +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Uint8Array +translation_of: Web/JavaScript/Reference/Global_Objects/Uint8Array +--- +{{JSRef}} + +**`Uint8Array`** は型付き配列で、 8 ビット符号なし整数値の配列を表します。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Uint8Array/Uint8Array", "Uint8Array()")}} + - : 新しい `Uint8Array` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint8Array.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Uint8Array` の場合は `1` です。 +- {{jsxref("TypedArray.name", "Uint8Array.name")}} + - : コンストラクター名を文字列値で返します。`Uint8Array` の場合、 "`Uint8Array`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Uint8Array.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Uint8Array` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Uint8Array.of()")}} + - : 可変長引数で新しい `Uint8Array` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Uint8Array.prototype.buffer")}} + - : `Uint8Array` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Uint8Array.prototype.byteLength")}} + - : `Uint8Array` の長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Uint8Array.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Uint8Array` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Uint8Array.prototype.length")}} + - : `Uint8Array` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Uint8Array.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Uint8Array.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Uint8Array.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Uint8Array.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Uint8Array.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Uint8Array.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Uint8Array.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Uint8Array.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Uint8Array.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Uint8Array.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Uint8Array.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Uint8Array.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Uint8Array.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Uint8Array.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Uint8Array.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Uint8Array.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Uint8Array.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Uint8Array.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Uint8Array.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Uint8Array.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Uint8Array.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Uint8Array.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Uint8Array` を返します。 +- {{jsxref("TypedArray.values", "Uint8Array.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Uint8Array.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Uint8Array.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Uint8Array.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Uint8Array` を作成 + +```js +// 長さから +var uint8 = new Uint8Array(2); +uint8[0] = 42; +console.log(uint8[0]); // 42 +console.log(uint8.length); // 2 +console.log(uint8.BYTES_PER_ELEMENT); // 1 + +// 配列から +var arr = new Uint8Array([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Uint8Array([21, 31]); +var y = new Uint8Array(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(8); +var z = new Uint8Array(buffer, 1, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var uint8 = new Uint8Array(iterable); +// Uint8Array[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Uint8Array` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} diff --git a/files/ja/web/javascript/reference/global_objects/uint8clampedarray/index.html b/files/ja/web/javascript/reference/global_objects/uint8clampedarray/index.html deleted file mode 100644 index f75d81f605..0000000000 --- a/files/ja/web/javascript/reference/global_objects/uint8clampedarray/index.html +++ /dev/null @@ -1,167 +0,0 @@ ---- -title: Uint8ClampedArray -slug: Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray -tags: - - Class - - JavaScript - - TypedArray - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray ---- -<div>{{JSRef}}</div> - -<p><strong><code>Uint8ClampedArray</code></strong> は型付き配列であり、 0-255 に制約される 8 ビット符号なし整数値の配列を生成します。指定された値が [0,255] の範囲を超えた場合、 0 または 255 が代わりに設定されます。整数以外を指定しようとすると、最も近い整数が設定されます。中身は <code>0</code> で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。</p> - -<h2 id="Constructor" name="Constructor">コンストラクター</h2> - -<dl> - <dt>{{jsxref("Global_Objects/Uint8ClampedArray/Uint8ClampedArray", "Uint8ClampedArray()")}}</dt> - <dd>新しい <code>Uint8ClampedArray</code> オブジェクトを生成します。</dd> -</dl> - -<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint8ClampedArray.BYTES_PER_ELEMENT")}}</dt> - <dd>要素の大きさの数値を返します。 <code>Uint8ClampedArray</code> の場合は <code>1</code> になります。</dd> - <dt>{{jsxref("TypedArray.name", "Uint8ClampedArray.name")}}</dt> - <dd>コンストラクターの名前を文字列値で返します。 <code>Uint8ClampedArray</code> 型の場合は "<code>Uint8ClampedArray</code>" です。</dd> -</dl> - -<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.from", "Uint8ClampedArray.from()")}}</dt> - <dd>新しい <code>Uint8ClampedArray</code> を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.of", "Uint8ClampedArray.of()")}}</dt> - <dd>新しい <code>Uint8ClampedArray</code> を、可変長引数から生成します。 {{jsxref("Array.of()")}} も参照してください。</dd> -</dl> - -<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.buffer", "Uint8ClampedArray.prototype.buffer")}}</dt> - <dd><code>Uint8ClampedArray</code> オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength", "Uint8ClampedArray.prototype.byteLength")}}</dt> - <dd><code>Uint8ClampedArray</code> の長さを {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset", "Uint8ClampedArray.prototype.byteOffset")}}</dt> - <dd><code>Uint8ClampedArray</code> のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、<strong>読取専用</strong>です。</dd> - <dt>{{jsxref("TypedArray.prototype.length", "Uint8ClampedArray.prototype.length")}}</dt> - <dd><code>Uint8ClampedArray</code> オブジェクト内に保持されている要素の数を返します。構築時に設定され、<strong>読取専用</strong>です。</dd> -</dl> - -<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> - -<dl> - <dt>{{jsxref("TypedArray.copyWithin", "Uint8ClampedArray.prototype.copyWithin()")}}</dt> - <dd>配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.entries", "Uint8ClampedArray.prototype.entries()")}}</dt> - <dd>配列内の各添字に対するキーと値の組を含む、新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.every", "Uint8ClampedArray.prototype.every()")}}</dt> - <dd>配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.fill", "Uint8ClampedArray.prototype.fill()")}}</dt> - <dd>配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.filter", "Uint8ClampedArray.prototype.filter()")}}</dt> - <dd>この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が <code>true</code> を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.find", "Uint8ClampedArray.prototype.find()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は <code>undefined</code> を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.findIndex", "Uint8ClampedArray.prototype.findIndex()")}}</dt> - <dd>指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.forEach", "Uint8ClampedArray.prototype.forEach()")}}</dt> - <dd>配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.includes", "Uint8ClampedArray.prototype.includes()")}}</dt> - <dd>型付き配列にある要素が含まれているかどうかを判断し、それに応じて <code>true</code> または <code>false</code> を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.indexOf", "Uint8ClampedArray.prototype.indexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.join", "Uint8ClampedArray.prototype.join()")}}</dt> - <dd>すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.keys", "Uint8ClampedArray.prototype.keys()")}}</dt> - <dd>配列内のすべての添字に対するキーを含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.lastIndexOf", "Uint8ClampedArray.prototype.lastIndexOf()")}}</dt> - <dd>配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は <code>-1</code> を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.map", "Uint8ClampedArray.prototype.map()")}}</dt> - <dd>この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduce", "Uint8ClampedArray.prototype.reduce()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reduceRight", "Uint8ClampedArray.prototype.reduceRight()")}}</dt> - <dd>アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.reverse", "Uint8ClampedArray.prototype.reverse()")}}</dt> - <dd>配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.set", "Uint8ClampedArray.prototype.set()")}}</dt> - <dd>指定された配列から複数の入力値を読み込み、型付き配列に格納します。</dd> - <dt>{{jsxref("TypedArray.slice", "Uint8ClampedArray.prototype.slice()")}}</dt> - <dd>配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.some", "Uint8ClampedArray.prototype.some()")}}</dt> - <dd>この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に <code>true</code> を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.sort", "Uint8ClampedArray.prototype.sort()")}}</dt> - <dd>配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.subarray", "Uint8ClampedArray.prototype.subarray()")}}</dt> - <dd>指定された開始位置と終了位置の間にある要素から新しい <code>Uint8ClampedArray</code> を返します。</dd> - <dt>{{jsxref("TypedArray.values", "Uint8ClampedArray.prototype.values()")}}</dt> - <dd>配列内の各添字に対する値を含む新しい<em>配列イテレーター</em>を返します。 {{jsxref("Array.prototype.values()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toLocaleString", "Uint8ClampedArray.prototype.toLocaleString()")}}</dt> - <dd>配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.toString", "Uint8ClampedArray.prototype.toString()")}}</dt> - <dd>配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。</dd> - <dt>{{jsxref("TypedArray.@@iterator", "Uint8ClampedArray.prototype[@@iterator]()")}}</dt> - <dd>配列内のそれぞれの添字の値を含む新しい<em>配列イテレーター</em>オブジェクトを返します。</dd> -</dl> - -<h2 id="Examples" name="Examples">例</h2> - -<h3 id="Different_ways_to_create_a_Uint8ClampedArray" name="Different_ways_to_create_a_Uint8ClampedArray">Uint8ClampedArray を生成する様々な方法</h3> - -<pre class="brush: js notranslate">// 長さを指定 -var uintc8 = new Uint8ClampedArray(2); -uintc8[0] = 42; -uintc8[1] = 1337; -console.log(uintc8[0]); // 42 -console.log(uintc8[1]); // 255 (clamped) -console.log(uintc8.length); // 2 -console.log(uintc8.BYTES_PER_ELEMENT); // 1 - -// 配列から -var arr = new Uint8ClampedArray([21,31]); -console.log(arr[1]); // 31 - -// 他の型付き配列から -var x = new Uint8ClampedArray([21, 31]); -var y = new Uint8ClampedArray(x); -console.log(y[0]); // 21 - -// ArrayBuffer から -var buffer = new ArrayBuffer(8); -var z = new Uint8ClampedArray(buffer, 1, 4); - -// 反復可能オブジェクトから -var iterable = function*(){ yield* [1,2,3]; }(); -var uintc8 = new Uint8ClampedArray(iterable); -// Uint8ClampedArray[1, 2, 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', '#table-49', 'TypedArray constructors')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.Uint8ClampedArray")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript 型付き配列</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("DataView")}}</li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/uint8clampedarray/index.md b/files/ja/web/javascript/reference/global_objects/uint8clampedarray/index.md new file mode 100644 index 0000000000..4c3a6284cf --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/uint8clampedarray/index.md @@ -0,0 +1,148 @@ +--- +title: Uint8ClampedArray +slug: Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray +tags: + - クラス + - JavaScript + - TypedArray + - 型付き配列 + - ポリフィル +browser-compat: javascript.builtins.Uint8ClampedArray +translation_of: Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray +--- +{{JSRef}} + +**`Uint8ClampedArray`** は型付き配列で、 0-255 に制約される 8 ビット符号なし整数値の配列を表します。指定された値が \[0,255] の範囲を超えた場合、 0 または 255 が代わりに設定されます。整数以外を指定しようとすると、最も近い整数が設定されます。中身は `0` で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。 + +## コンストラクター + +- {{jsxref("Global_Objects/Uint8ClampedArray/Uint8ClampedArray", "Uint8ClampedArray()")}} + - : 新しい `Uint8ClampedArray` オブジェクトを生成します。 + +## 静的プロパティ + +- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint8ClampedArray.BYTES_PER_ELEMENT")}} + - : 要素の大きさを数値で返します。`Uint8ClampedArray` の場合は `1` です。 +- {{jsxref("TypedArray.name", "Uint8ClampedArray.name")}} + - : コンストラクター名を文字列値で返します。`Uint8ClampedArray` の場合、 "`Uint8ClampedArray`" です。 + +## 静的メソッド + +- {{jsxref("TypedArray.from", "Uint8ClampedArray.from()")}} + - : 配列風オブジェクトまたは反復可能オブジェクトから新しい `Uint8ClampedArray` オブジェクトを生成します。 {{jsxref("Array.from()")}} も参照してください。 +- {{jsxref("TypedArray.of", "Uint8ClampedArray.of()")}} + - : 可変長引数で新しい `Uint8ClampedArray` オブジェクトを生成します。{{jsxref("Array.of()")}} も参照してください。 + +## インスタンスプロパティ + +- {{jsxref("TypedArray.prototype.buffer", "Uint8ClampedArray.prototype.buffer")}} + - : `Uint8ClampedArray` オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteLength", "Uint8ClampedArray.prototype.byteLength")}} + - : `Uint8ClampedArray` の {{jsxref("ArrayBuffer")}} の先頭からの長さを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.byteOffset", "Uint8ClampedArray.prototype.byteOffset")}} + - : {{jsxref("ArrayBuffer")}} の先頭からの `Uint8ClampedArray` のオフセットを (バイト単位で) 返します。構築時に固定され、**読み取り専用**です。 +- {{jsxref("TypedArray.prototype.length", "Uint8ClampedArray.prototype.length")}} + - : `Uint8ClampedArray` オブジェクト内に保持されている要素の数を返します。構築時に固定され、**読み取り専用**です。 + +## インスタンスメソッド + +- {{jsxref("TypedArray.copyWithin", "Uint8ClampedArray.prototype.copyWithin()")}} + - : 配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}} も参照してください。 +- {{jsxref("TypedArray.entries", "Uint8ClampedArray.prototype.entries()")}} + - : 配列内ですべての位置におけるキーと値の組を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.entries()")}} も参照してください。 +- {{jsxref("TypedArray.every", "Uint8ClampedArray.prototype.every()")}} + - : 配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。{{jsxref("Array.prototype.every()")}} も参照してください。 +- {{jsxref("TypedArray.fill", "Uint8ClampedArray.prototype.fill()")}} + - : 配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。{{jsxref("Array.prototype.fill()")}} も参照してください。 +- {{jsxref("TypedArray.filter", "Uint8ClampedArray.prototype.filter()")}} + - : この配列のすべての要素のうち、与えられたフィルタリング関数が `true` を返すものをもつ新しい配列を生成します。{{jsxref("Array.prototype.filter()")}} も参照してください。 +- {{jsxref("TypedArray.find", "Uint8ClampedArray.prototype.find()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければ `undefined` を返します。{{jsxref("Array.prototype.find()")}} も参照してください。 +- {{jsxref("TypedArray.findIndex", "Uint8ClampedArray.prototype.findIndex()")}} + - : 配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ `-1` を返します。{{jsxref("Array.prototype.findIndex()")}} も参照してください。 +- {{jsxref("TypedArray.forEach", "Uint8ClampedArray.prototype.forEach()")}} + - : 配列内のそれぞれの要素について関数を呼び出します。{{jsxref("Array.prototype.forEach()")}} も参照してください。 +- {{jsxref("TypedArray.includes", "Uint8ClampedArray.prototype.includes()")}} + - : 型付き配列に特定の要素があるかどうかを判断し、それに応じて `true` か `false`を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。 +- {{jsxref("TypedArray.indexOf", "Uint8ClampedArray.prototype.indexOf()")}} + - : 指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.indexOf()")}} も参照してください。 +- {{jsxref("TypedArray.join", "Uint8ClampedArray.prototype.join()")}} + - : 配列のすべての要素を 1 つの文字列に結合します。{{jsxref("Array.prototype.join()")}} も参照してください。 +- {{jsxref("TypedArray.keys", "Uint8ClampedArray.prototype.keys()")}} + - : 配列内ですべての位置におけるキーを提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.keys()")}} も参照してください。 +- {{jsxref("TypedArray.lastIndexOf", "Uint8ClampedArray.prototype.lastIndexOf()")}} + - : 指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、 `-1` を返します。{{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。 +- {{jsxref("TypedArray.map", "Uint8ClampedArray.prototype.map()")}} + - : この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。{{jsxref("Array.prototype.map()")}} も参照してください。 +- {{jsxref("TypedArray.reduce", "Uint8ClampedArray.prototype.reduce()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduce()")}} も参照してください。 +- {{jsxref("TypedArray.reduceRight", "Uint8ClampedArray.prototype.reduceRight()")}} + - : アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。{{jsxref("Array.prototype.reduceRight()")}} も参照してください。 +- {{jsxref("TypedArray.reverse", "Uint8ClampedArray.prototype.reverse()")}} + - : 配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}} も参照してください。 +- {{jsxref("TypedArray.set", "Uint8ClampedArray.prototype.set()")}} + - : 入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。 +- {{jsxref("TypedArray.slice", "Uint8ClampedArray.prototype.slice()")}} + - : 配列の一部を取り出して新しい配列を返します。{{jsxref("Array.prototype.slice()")}} も参照してください。 +- {{jsxref("TypedArray.some", "Uint8ClampedArray.prototype.some()")}} + - : この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合に `true` を返します。{{jsxref("Array.prototype.some()")}} も参照してください。 +- {{jsxref("TypedArray.sort", "Uint8ClampedArray.prototype.sort()")}} + - : 配列の要素をその場で並べ替え、その配列を返します。{{jsxref("Array.prototype.sort()")}} も参照してください。 +- {{jsxref("TypedArray.subarray", "Uint8ClampedArray.prototype.subarray()")}} + - : 指定された先頭と末尾の要素位置から新しい `Uint8ClampedArray` を返します。 +- {{jsxref("TypedArray.values", "Uint8ClampedArray.prototype.values()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。{{jsxref("Array.prototype.values()")}} も参照してください。 +- {{jsxref("TypedArray.toLocaleString", "Uint8ClampedArray.prototype.toLocaleString()")}} + - : 配列とその要素を表すローカライズされた文字列を返します。{{jsxref("Array.prototype.toLocaleString()")}} も参照してください。 +- {{jsxref("TypedArray.toString", "Uint8ClampedArray.prototype.toString()")}} + - : 配列とその要素を表す文字列を返します。{{jsxref("Array.prototype.toString()")}} も参照してください。 +- {{jsxref("TypedArray.@@iterator", "Uint8ClampedArray.prototype[@@iterator]()")}} + - : 配列内ですべての位置における値を提供する新しい*配列イテレーター*を返します。 + +## 例 + +### 様々な方法で `Uint8ClampedArray` を作成 + +```js +// 長さから +var uintc8 = new Uint8ClampedArray(2); +uintc8[0] = 42; +uintc8[1] = 1337; +console.log(uintc8[0]); // 42 +console.log(uintc8[1]); // 255 (制約を受けた) +console.log(uintc8.length); // 2 +console.log(uintc8.BYTES_PER_ELEMENT); // 1 + +// 配列から +var arr = new Uint8ClampedArray([21,31]); +console.log(arr[1]); // 31 + +// From another TypedArray +var x = new Uint8ClampedArray([21, 31]); +var y = new Uint8ClampedArray(x); +console.log(y[0]); // 21 + +// ArrayBuffer から +var buffer = new ArrayBuffer(8); +var z = new Uint8ClampedArray(buffer, 1, 4); + +// 反復可能オブジェクトから +var iterable = function*(){ yield* [1,2,3]; }(); +var uintc8 = new Uint8ClampedArray(iterable); +// Uint8ClampedArray[1, 2, 3] +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `Uint8ClampedArray` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("ArrayBuffer")}} +- {{jsxref("DataView")}} |