TypedArray.prototype.set()

¥Syntax

set(array)
set(array, targetOffset)

set(typedarray)
set(typedarray, targetOffset)

¥Parameters

array

要从中复制值的数组。源数组中的所有值都会复制到目标数组中，除非源数组的长度加上目标偏移量超过了目标数组的长度，在这种情况下会引发异常。

typedarray

如果源数组是类型数组，则两个数组可能共享相同的底层 ArrayBuffer；JavaScript 引擎会智能地将缓冲区的源范围复制到目标范围。

targetOffset Optional

开始从源数组写入值的目标数组的偏移量。如果省略该值，则假定为 0（即，源数组将覆盖目标数组中从索引 0 开始的值）。

¥Return value

无 (undefined)。

¥None (undefined).

¥Exceptions

RangeError

有下列情况之一的，抛出：

• 元素将存储在类型化数组末尾之外，因为 targetOffset 太大，或者因为 array 或 typedarray 太大。
• targetOffset 为负。

¥Examples

¥Using set()

const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

uint8.set([1, 2, 3], 3);

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

¥See also

• core-js 中 TypedArray.prototype.set 的 Polyfill
• JavaScript 类型数组 指南
• TypedArray
• ArrayBuffer