TypedArray.prototype.subarray()

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

用法

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

参数

begin 可选

元素开始的索引，开始索引的元素将会被包括。若该值没有传入，将会返回一个拥有全部元素的数组。

end 可选

元素结束的索引，结束索引的元素将不会被包括。若该值没有传入，从 begin 所指定的那一个元素到数组末尾的所有元素都将会被包含进新数组中。

返回值

一个新的 TypedArray 对象。

说明

• 被 begin 和 end 指定的范围将会收束与当前数组的有效索引
• 若计算后得出的长度是负数，将会被收束成0
• 若 begin 或 end 是负数，将会被当做成是从数组末端读取的索引

需要注意的是，使用该方法返回的新数组还是建立在原有的 Buffer 之上的，所以，改动数组的内容将会影响到原数组，反之亦然。

Examples

Using the subarray method

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 ]

Specifications

Browser compatibility

See also

• JavaScript typed arrays
• TypedArray
• ArrayBuffer