TypedArray.prototype.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 ]

规范文档

文档 状态 说明
Typed Array Specification Obsolete ECMAScript 6中已废弃。
ECMAScript 2015 (6th Edition, ECMA-262)
TypedArray.prototype.set		 Standard 在ECMA标准中初始定义。
ECMAScript Latest Draft (ECMA-262)
TypedArray.prototype.set		 Draft  

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

浏览器 Chrome Firefox (Gecko) Internet Explorer Opera Safari
最低版本 7.0 4.0 (2) 10 11.6 5.1
浏览器 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
最低版本 4.0 (Yes) 4.0 (2) 10 11.6 4.2

另可参考

  1. JavaScript 标准库
  2. TypedArray
  3. 属性
    1. TypedArray.BYTES_PER_ELEMENT
    2. TypedArray.name
    3. TypedArray.prototype
    4. TypedArray.prototype.buffer
    5. TypedArray.prototype.byteLength
    6. TypedArray.prototype.byteOffset
    7. TypedArray.prototype.length
    8. get TypedArray[@@species]
  4. 方法
    1. TypedArray.from()
    2. TypedArray.of()
    3. TypedArray.prototype.copyWithin()
    4. TypedArray.prototype.entries()
    5. TypedArray.prototype.every()
    6. TypedArray.prototype.fill()
    7. TypedArray.prototype.filter()
    8. TypedArray.prototype.find()
    9. TypedArray.prototype.findIndex()
    10. TypedArray.prototype.forEach()
    11. TypedArray.prototype.includes()
    12. TypedArray.prototype.indexOf()
    13. TypedArray.prototype.join()
    14. TypedArray.prototype.keys()
    15. TypedArray.prototype.lastIndexOf()
    16. TypedArray.prototype.map()
    17. TypedArray.prototype.move()
    18. TypedArray.prototype.reduce()
    19. TypedArray.prototype.reduceRight()
    20. TypedArray.prototype.reverse()
    21. TypedArray.prototype.set()
    22. TypedArray.prototype.slice()
    23. TypedArray.prototype.some()
    24. TypedArray.prototype.sort()
    25. TypedArray.prototype.subarray()
    26. TypedArray.prototype.toLocaleString()
    27. TypedArray.prototype.toString()
    28. TypedArray.prototype.values()
    29. TypedArray.prototype[@@iterator]()
  5. Related pages:
  6. Int8Array
  7. Uint8Array
  8. Uint8ClampedArray
  9. Int16Array
  10. Uint16Array
  11. Int32Array
  12. Uint32Array
  13. Float32Array
  14. Float64Array
  15. 继承
  16. Function
  17. 属性
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  18. 方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  19. Object
  20. 属性
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  21. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()