TypedArray.prototype.set()

概要

指定した配列から入力値を読み込み、複数の値をtyped array内に格納します。

構文

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

引数

array

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

typedarray

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

offset Optional

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

エラースロー

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