TypedArray.prototype.set()

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

構文

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

引数

array

ソース配列の長さ+オフセットがコピー先の配列の長さを超えてない限り、値をコピーする配列。コピー元の配列からのすべての値は、コピー先の配列にコピーされます。超える場合は、例外がスローされます。

typedarray

コピー元の配列が typed array の場合、二つの配列は同じ基礎をなす ArrayBuffer を共有するかもしれません。; ブラウザはバッファのコピー元の範囲をコピー先の範囲にスマートにコピーします。

offset Optional

コピー元 array から値を書き始めるターゲット配列のオフセット。この値が省略された場合、0 とみなされます(すなわち、コピー元の array はインデックス 0 で開始するコピー先の配列の値を上書きします)。

戻り値

undefined。

エラースロー

RangeError

offset が typed array の終端を越えて格納されるように設定されたらスローされます。

例

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 typed arrays
• TypedArray
• ArrayBuffer