From 47793abfb96a7dd21ff7ad0cf498accc9e618a30 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 12 Sep 2021 23:02:36 +0900 Subject: Global_Objects/ArrayBuffer を更新 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 2021/07/21 時点の英語版に同期 - 一部翻訳を見直し --- .../global_objects/arraybuffer/index.html | 87 ---------------------- .../reference/global_objects/arraybuffer/index.md | 71 ++++++++++++++++++ 2 files changed, 71 insertions(+), 87 deletions(-) delete mode 100644 files/ja/web/javascript/reference/global_objects/arraybuffer/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/arraybuffer/index.md (limited to 'files/ja') diff --git a/files/ja/web/javascript/reference/global_objects/arraybuffer/index.html b/files/ja/web/javascript/reference/global_objects/arraybuffer/index.html deleted file mode 100644 index 790ccb2694..0000000000 --- a/files/ja/web/javascript/reference/global_objects/arraybuffer/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: ArrayBuffer -slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer -tags: - - ArrayBuffer - - Constructor - - JavaScript - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer ---- -
{{JSRef}}
- -

ArrayBuffer オブジェクトは、一般的な固定長の生のバイナリデータバッファを表現するために使用されます。

- -

ArrayBuffer はバイトの配列で、他の言語では「バイト配列」と呼ばれることが多いです。ArrayBuffer の内容を直接操作することはできません。代わりに、型付きの配列オブジェクトか {{jsxref("DataView")}} オブジェクトのいずれかを作成して、バッファを特定の形式で表現し、バッファの内容を読み書きするためにそれを使用します。

- -

ArrayBuffer() コンストラクタは、指定した長さの ArrayBuffer をバイト単位で作成します。Base64 文字列やローカルファイルなどの既存のデータから配列バッファを取得することもできます。

- -

コンストラクタ

- -
-
{{jsxref("ArrayBuffer.ArrayBuffer", "ArrayBuffer()")}}
-
新しい ArrayBuffer オブジェクトを作成します。
-
- -

静的プロパティ

- -
-
{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}
-
派生オブジェクトを作成する際に使用するコンストラクタ関数です。
-
- -

静的メソッド

- -
-
{{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}}
-
arg が型付き配列オブジェクトや {{jsxref("DataView")}} のような ArrayBuffer ビューのいずれかである場合に true を返します。それ以外の場合は false を返します。
-
- -

インスタンスプロパティ

- -
-
{{jsxref("ArrayBuffer.prototype.byteLength")}}
-
ArrayBuffer の読み取り専用サイズ (バイト単位)。これは配列が構築されたときに設定され、変更することはできません。
-
- -

インスタンスメソッド

- -
-
{{jsxref("ArrayBuffer.prototype.slice()")}}
-
ArrayBuffer のバイト数のコピーであり、その内容は、begin (含む) から end (排他的) までのバイト数である。begin または end のどちらかが負の値の場合は、配列の先頭からではなく、配列の末尾からのインデックスを指します。
-
- -

例

- -

ArrayBuffer の作成

- -

この例では、バッファを参照する {{jsxref("Int32Array")}} ビューを持つ 8 バイトバッファを作成します。

- -
const buffer = new ArrayBuffer(8);
-const view = new Int32Array(buffer);
- -

仕様

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-arraybuffer-objects', 'ArrayBuffer')}}
- -

ブラウザー実装状況

- -

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

- -

あわせて参照

- - diff --git a/files/ja/web/javascript/reference/global_objects/arraybuffer/index.md b/files/ja/web/javascript/reference/global_objects/arraybuffer/index.md new file mode 100644 index 0000000000..0841ce8811 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/arraybuffer/index.md @@ -0,0 +1,71 @@ +--- +title: ArrayBuffer +slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer +tags: + - ArrayBuffer + - クラス + - JavaScript + - リファレンス + - TypedArrays + - Polyfill +browser-compat: javascript.builtins.ArrayBuffer +translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer +--- +{{JSRef}} + +**`ArrayBuffer`** オブジェクトは、一般的な固定長の生のバイナリーデータバッファーを表現するために使用します。 + +`ArrayBuffer` はバイトの配列で、他の言語ではよく「バイト配列」と呼ばれます。`ArrayBuffer` の内容を直接操作することはできません。代わりに、バッファーを特定の形式で表現する[型付き配列オブジェクト](/ja/docs/Web/JavaScript/Reference/Global_Objects/TypedArray)または {{jsxref("DataView")}} オブジェクトのいずれか作成して、バッファーの内容を読み書きします。 + +[`ArrayBuffer()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/ArrayBuffer) コンストラクターは、指定した長さの `ArrayBuffer` をバイト単位で作成します。既存のデータから、たとえば、[Base64](/ja/docs/Glossary/Base64) 文字列や[ローカルファイルから](/ja/docs/Web/API/FileReader/readAsArrayBuffer)から配列バッファーを取得することもできます。 + +## コンストラクター + +- {{jsxref("ArrayBuffer.ArrayBuffer", "ArrayBuffer()")}} + - : 新しい `ArrayBuffer` オブジェクトを作成します。 + +## 静的プロパティ + +- {{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}} + - : 派生オブジェクトを作成する際に使用するコンストラクター関数です。 + +## 静的メソッド + +- {{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}} + - : `arg` が型付き配列オブジェクトや {{jsxref("DataView")}} のような ArrayBuffer ビューのいずれかである場合は `true` を返します。それ以外の場合は `false` を返します。 + +## インスタンスプロパティ + +- {{jsxref("ArrayBuffer.prototype.byteLength")}} + - : `ArrayBuffer` の長さ (バイト単位) で、読み取り専用です。これは配列が構築されたときに設定され、変更することはできません。 + +## インスタンスメソッド + +- {{jsxref("ArrayBuffer.prototype.slice()")}} + - : 新しい `ArrayBuffer` に、`begin` (の位置) から `end` (の手前) までのバイトのコピーを入れて返します。`begin` または `end` のどちらかが負の値の場合は、配列の先頭からではなく、配列の末尾からの位置を指します。 + +## 例 + +### ArrayBuffer の作成 + +この例では、バッファーを参照する {{jsxref("Int32Array")}} ビューを持つ 8 バイトバッファーを作成します。 + +```js +const buffer = new ArrayBuffer(8); +const view = new Int32Array(buffer); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- `ArrayBuffer` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます +- [JavaScript 型付き配列](/ja/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("SharedArrayBuffer")}} +- [RangeError: invalid array length](/ja/docs/Web/JavaScript/Reference/Errors/Invalid_array_length) -- cgit v1.2.3-54-g00ecf