TypedArray.prototype.subarray()

概要

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

構文

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

引数

begin Optional

初めの要素。オフセットは、含まれます。

end Optional

最後の要素。オフセットは、含まれません。指定されなかったら、beginによって指定された要素から配列の最後まですべての要素が新しいビューに含まれます。

説明

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

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

例

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 ]

仕様

ブラウザ実装状況

関連情報

• JavaScript typed arrays
• TypedArray
• ArrayBuffer