TypedArray.prototype.subarray()

同じ ArrayBuffer ストアで、TypedArray オブジェクトと同じ要素の型をもつ新しい TypedArray を返します。begin オフセットは包括的で、end オフセットは排他的です。 TypedArraytyped array types の一つです。

構文

typedarray.subarray([begin [,end]])

引数

begin Optional
初めの要素。オフセットが含まれます。この値が指定されていない場合、配列全体が新しいビューに含まれます。
end Optional
最後の要素。オフセットが含まれません。この値が指定されていない場合、 begin によって指定された要素から配列の最後まですべての要素が新しいビューに含まれます。

戻り値

新しい TypedArray オブジェクト

説明

beginend によって指定される範囲は、現在の配列に対して有効なインデックスの範囲に縮められます。すなわち、新しい範囲の計算された長さがマイナスなら、ゼロに縮められます。beginend のどちらかがマイナスなら、配列の最初からではなく、最後からインデックスを参照します。

既存のバッファ上に新しいビューを作っていることにも注意して下さい。すなわち、新しいオブジェクトの内容への変更は、元のオブジェクトに強い影響を与えます。逆もまた同様です。

subarray メソッドを使う

var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1,2,3]);

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

var sub = uint8.subarray(0,4);

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

仕様

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

ブラウザーの互換性

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

凡例

完全対応  
完全対応

関連情報