From 33c66e7c7a3352866f217e0ace0207d9a17fc125 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Wed, 15 Sep 2021 22:55:04 +0900 Subject: 型付き配列のクラスリファレンスを更新 (#2372) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Markdownに変換 - 2021/09/06時点の英語版に同期 --- .../global_objects/float32array/index.html | 197 --------------------- .../reference/global_objects/float32array/index.md | 146 +++++++++++++++ 2 files changed, 146 insertions(+), 197 deletions(-) delete mode 100644 files/ja/web/javascript/reference/global_objects/float32array/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/float32array/index.md (limited to 'files/ja/web/javascript/reference/global_objects/float32array') 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 ---- -
{{JSRef}}
- -

Float32Array タイプは、32 ビット浮動小数点数 (C 言語の float データタイプに相当します) の配列を表します。各要素のバイトオーダーはプラットフォームに依存します。もしコントロールしたい場合は代わりに{{jsxref("DataView")}}を使って下さい。各要素は0で初期化されます。生成された Float32Array オブジェクトのメソッドあるいは配列のような表記法 ("[]") を用いて、要素を参照することができます。

- -

構文

- -
new Float32Array(); // new in ES2017
-new Float32Array(length);
-new Float32Array(typedArray);
-new Float32Array(object);
-​new Float32Array(buffer [, byteOffset [, length]]);
- -

コンストラクタの構文とパラメータについての詳しい情報は{{jsxref("TypedArray")}}を参照して下さい。

- -

プロパティ

- -
-
{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Float32Array.BYTES_PER_ELEMENT")}}
-
要素一個あたりのバイト数を返します。Float32Array の場合は4です。
-
Float32Array.length
-
値は3になります。実際の長さ(要素数)については{{jsxref("TypedArray.prototype.length", "Float32Array.prototype.length")}}を参照して下さい。
-
{{jsxref("TypedArray.name", "Float32Array.name")}}
-
コンストラクタ名を文字列値で返します。Float32Array の場合、"Float32Array"です。
-
{{jsxref("TypedArray.prototype", "Float32Array.prototype")}}
-
TypedArray オブジェクトのプロトタイプです。
-
- -

メソッド

- -
-
{{jsxref("TypedArray.from", "Float32Array.from()")}}
-
配列状のオブジェクトやイテレート可能なオブジェクトから、新たな Float32Array オブジェクトを生成します。{{jsxref("Array.from()")}}も確かめて下さい。
-
{{jsxref("TypedArray.of", "Float32Array.of()")}}
-
可変長引数で新しい Float32Array オブジェクトを生成します。{{jsxref("Array.of()")}}も確かめて下さい。
-
- -

Float32Array プロトタイプ

- -

全ての Float32Array オブジェクトは {{jsxref("TypedArray.prototype", "%TypedArray%.prototype")}} を継承しています。

- -

プロパティ

- -
-
Float32Array.prototype.constructor
-
インスタンスのプロトタイプを作る関数を返します。これは、デフォルトで対応する Float32Array コンストラクタです。
-
{{jsxref("TypedArray.prototype.buffer", "Float32Array.prototype.buffer")}} {{readonlyInline}}
-
Float32Array オブジェクトによって参照される{{jsxref("ArrayBuffer")}}を返します。構築時に設定され、読取専用となります。
-
{{jsxref("TypedArray.prototype.byteLength", "Float32Array.prototype.byteLength")}} {{readonlyInline}}
-
{{jsxref("ArrayBuffer")}}の開始位置からのFloat32Array オブジェクトの(バイト単位の)長さを返します。構築時に設定され、読取専用となります。
-
{{jsxref("TypedArray.prototype.byteOffset", "Float32Array.prototype.byteOffset")}} {{readonlyInline}}
-
{{jsxref("ArrayBuffer")}}の開始位置からのFloat32Array オブジェクトの(バイト単位の)オフセットを返します。構築時に設定され、読取専用となります。
-
{{jsxref("TypedArray.prototype.length", "Float32Array.prototype.length")}} {{readonlyInline}}
-
Float32Array オブジェクト内に保持された要素の数を返します。構築時に設定され、読取専用となります。
-
-

メソッド

-
-
{{jsxref("TypedArray.prototype.copyWithin()", "Float32Array.prototype.copyWithin()")}}
-
配列内で一連の配列要素をコピーします。{{jsxref("Array.prototype.copyWithin()")}}も確かめて下さい。
-
{{jsxref("TypedArray.entries", "Float32Array.prototype.entries()")}}
-
配列内で各インデックスに対して、キー／バリュー　ペアを含む新しいArray Iteratorを返します。{{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()")}}  {{experimental_inline}}
-
typed arrayがある要素を含むかどうか判断し、それに応じて、true か falseを返します。 {{jsxref("Array.prototype.includes()")}}も確かめて下さい。
-
{{jsxref("TypedArray.indexOf", "Float32Array.prototype.indexOf()")}}
-
指定された値に等しい配列内の要素の最初のインデックスを返します。見つからない場合、-1を返します。{{jsxref("Array.prototype.indexOf()")}}も確かめて下さい。
-
{{jsxref("TypedArray.join", "Float32Array.prototype.join()")}}
-
すべての配列要素を文字列に結合します。{{jsxref("Array.prototype.join()")}}も確かめて下さい。
-
{{jsxref("TypedArray.keys", "Float32Array.prototype.keys()")}}
-
配列内の各インデックスに対するキーを含む新しいArray Iteratorを返します。{{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()")}}
-
アキュムレータに対して関数を適用し、隣り合う二つのtyped arrayの要素(左から右へ)は単一の値になります。{{jsxref("Array.prototype.reduce()")}}も確かめて下さい。
-
{{jsxref("TypedArray.reduceRight", "Float32Array.prototype.reduceRight()")}}
-
アキュムレータに対して関数を適用し、隣り合う二つのtyped arrayの要素(右から左へ)は単一の値になります。{{jsxref("Array.prototype.reduceRight()")}}を確かめて下さい。
-
{{jsxref("TypedArray.reverse", "Float32Array.prototype.reverse()")}}
-
配列要素の順番を反転させます。— 最初の要素は最後になり、最後の要素は最初になります。{{jsxref("Array.prototype.reverse()")}}も確かめて下さい。
-
{{jsxref("TypedArray.set", "Float32Array.prototype.set()")}}
-
入力値を指定した配列から読み込み、typed array内に複数の値を格納します。
-
{{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()")}}
-
配列内で各インデックスに対する値を含む新しいArray Iteratorオブジェクトを返します。{{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]()")}}
-
配列内で各インデックスに対する値を含む新しいArray Iteratorオブジェクトを返します。
-
- -

例

- -
// 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]
- -

仕様

- - - - - - - - - - - - - - - - - - - - - - - - -
仕様書策定状況コメント
{{SpecName('Typed Array')}}{{Spec2('Typed Array')}}ECMAScript 6 で置き換えられました。
{{SpecName('ES6', '#table-49', 'TypedArray constructors')}}{{Spec2('ES6')}}ECMA 標準では最初の定義。new 演算子が必要なことが仕様書に含まれました。
{{SpecName('ESDraft', '#table-49', 'TypedArray constructors')}}{{Spec2('ESDraft')}}
- -

ブラウザ実装状況

- - - -

{{Compat("javascript.builtins.Float32Array")}}

- -

互換性について

- -

ECMAScript 2015 (ES6)から、Float32Array コンストラクタでインスタンスを生成する場合、 {{jsxref("Operators/new", "new")}} 演算子が必要となります。 Float32Array を new 演算子を使用せずに関数呼び出しした場合、{{jsxref("TypeError")}} 例外が投げられるでしょう。

- -
var dv = Float32Array([1, 2, 3]);
-// TypeError: calling a builtin Float32Array constructor
-// without new is forbidden
- -
var dv = new Float32Array([1, 2, 3]);
- -

関連情報

- - 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")}} -- cgit v1.2.3-54-g00ecf