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 ]

仕様書

仕様書
ECMAScript (ECMA-262)
TypedArray.prototype.set の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
setChrome 完全対応 7Edge 完全対応 14Firefox 完全対応 4IE 完全対応 10Opera 完全対応 11.6Safari 完全対応 5.1WebView Android 完全対応 4Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 12Safari iOS 完全対応 4.2Samsung Internet Android 完全対応 1.0nodejs 完全対応 0.10

凡例

完全対応  
完全対応

関連情報