在线文档教程

typedArray.set

typedArray.set

set()方法用于从指定数组中读取值,并将其存储在类型化数组中。

语法

typedarr.set(array [,offset]) typedarr.set(typedarray [,offset])

参数

array参数array是源数组,指定从哪里拷贝值。源数组中的所有值都会被拷贝到目标数组中去。如果源数组的长度加上偏移值offset的结果超过目标数组的长度,则会抛出异常错误。typedarray如果源数组是一个类型化数组(typed array),则源数组和目标数组会共享同一个底层的ArrayBuffer;浏览器将会智能地将buffer的指定区段拷贝到目标区段中去。offset可选偏移量参数offset指定从什么地方开始使用源数组array的值进行重写。如果忽略该参数,则默认为0(也就是说,从目标数组的下标为0处开始,使用源数组array的值覆盖重写)。

返回值

undefined.

抛出的错误异常

RangeError如果指定的偏移量超出了类型化数组的范围,则该异常会被抛出。

示例

使用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 ]

规范

SpecificationStatusComment
Typed Array SpecificationObsoleteSuperseded by ECMAScript 6.
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'TypedArray.prototype.set' in that specification.StandardInitial definition in an ECMA standard.
ECMAScript Latest Draft (ECMA-262)The definition of 'TypedArray.prototype.set' in that specification.Living Standard

浏览器兼容性

FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support7.04.0 (2)1011.65.1

FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support4.0(Yes)4.0 (2)1011.64.2