TypedArray.prototype.set()

set() メソッドは、複数の値を指定した配列から入力値を読み込み、型付き配列に格納します。

構文

typedarray.set(array[, offset])
typedarray.set(typedarray[, offset])

引数

array

値のコピーする配列です。コピー元の配列からのすべての値がコピー先の配列にコピーされます。ただし、コピー元の配列の長さにオフセットを加えた長さがコピー先の配列の長さを超えた場合は、例外が発生します。

typedarray

コピー元の配列が型付き配列の場合、2つの配列は同じ ArrayBuffer を共有することができます。 JavaScript エンジンは、バッファのコピー元の範囲をコピー先の範囲にインテリジェントに copy します。

offset Optional

コピー先の配列へのオフセットで、コピー元の配列からの値の書き込みを開始する位置です。この値を省略した場合は 0 と見なされます (つまり、コピー元の配列はインデックス 0 から始まるコピー先配列の値を上書きします)。

例外

RangeError: offset が型付けされた配列の最後を超えて格納されるように設定されていた場合。

例

set() の使用

var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);

uint8.set([1, 2, 3], 3);

console.log(uint8); // Uint8Array [ 0, 0, 0, 1, 2, 3, 0, 0 ]

仕様書

ブラウザーの互換性

関連情報

• JavaScript 型付き配列
• TypedArray
• ArrayBuffer