Uint8ClampedArray
Uint8ClampedArray
(8位无符号整型固定数组)
类型化数组表示一个由值固定在0-255区间的8位无符号整型组成的数组;如果你指定一个在 [0,255] 区间外的值,它将被替换为0或255;如果你指定一个非整数,那么它将被设置为最接近它的整数。(数组)内容被初始化为0。一旦(数组)被创建,你可以使用对象的方法引用数组里的元素,或使用标准的数组索引语法(即使用方括号标记)。
语法
new Uint8ClampedArray(); // new in ES2017
new Uint8ClampedArray(length);
new Uint8ClampedArray(typedArray);
new Uint8ClampedArray(object);
new Uint8ClampedArray(buffer [, byteOffset [, length]]);
关于构造函数语法和参数的更多信息,参见 TypedArray 。
属性
Uint8ClampedArray.BYTES_PER_ELEMENT
返回元素大小的一个数值。对
Uint8ClampedArray
而言是1。
Uint8ClampedArray.length
静态长度属性值为0。对于实际长度(元素的数量),见
Uint8ClampedArray.prototype.length
。
Uint8ClampedArray.name
返回构造函数名的字符串值。对
Uint8ClampedArray
类型而言:"Uint8ClampedArray"。
Uint8ClampedArray.prototype
原型是
TypedArray
(类型化数组)对象。
方法
Uint8ClampedArray.from()
从一个类数组或可枚举对象创建一个新的
Uint8ClampedArray
。参见
Array.from()
。
Uint8ClampedArray.of()
通过一个可选数量参数来创建一个新的
Uint8ClampedArray
。参见
Array.of()
。
Uint8ClampedArray
prototype
所有的
Uint8ClampedArray
对象继承自
%TypedArray%.prototype
。
属性
Uint8ClampedArray.prototype.constructor
返回创建一个实例原型的函数。这是
Uint8ClampedArray
默认的构造函数。
Uint8ClampedArray.prototype.buffer
只读返回由
Uint8ClampedArray
引用的
ArrayBuffer
。在创建时所固定下来,因此
只能读取
。
Uint8ClampedArray.prototype.byteLength
只读返回从
ArrayBuffer
开始的
Uint8ClampedArray
的(字节的)长度。在创建时所固定下来,因此
只能读取
。
Uint8ClampedArray.prototype.byteOffset
只读返回从
ArrayBuffer
开始的
Uint8ClampedArray
的(字节的)偏移。在创建时所固定下来,因此
只能读取
。
Uint8ClampedArray.prototype.length
只读返回
UintClamped8Array
具有的元素数量。在创建时所固定下来,因此
只能读取
。
Methods
Uint8ClampedArray.prototype.copyWithin()
复制数组中的一系列数组元素。另见
Array.prototype.copyWithin()
。
Uint8ClampedArray.prototype.entries()
返回
Array Iterator
包含数组中每个索引的键/值对的新对象。另见
Array.prototype.entries()
。
Uint8ClampedArray.prototype.every()
测试数组中的所有元素是否都通过了函数提供的测试。另见
Array.prototype.every()
。
Uint8ClampedArray.prototype.fill()
用静态值填充从开始索引到结束索引的数组的所有元素。另见
Array.prototype.fill()
。
Uint8ClampedArray.prototype.filter()
使用提供的过滤函数返回true的数组的所有元素创建一个新数组。另见
Array.prototype.filter()
。
Uint8ClampedArray.prototype.find()
如果数组中的元素满足提供的测试函数或者
undefined
未找到,则返回数组中找到的值。另见
Array.prototype.find()
。
Uint8ClampedArray.prototype.findIndex()
如果数组中的元素满足提供的测试函数,则返回数组中找到的索引;如果未找到,则返回-1。另见
Array.prototype.findIndex()
。
Uint8ClampedArray.prototype.forEach()
为数组中的每个元素调用一个函数。另见
Array.prototype.forEach()
。
Uint8ClampedArray.prototype.includes()
确定类型数组是否包含某个元素,返回
true
还是
false
适当的。另见
Array.prototype.includes()
。
Uint8ClampedArray.prototype.indexOf()
返回数组中等于指定值的元素的第一个(最少)索引,如果没有找到,则返回-1。另见
Array.prototype.indexOf()
。
Uint8ClampedArray.prototype.join()
将数组的所有元素连接成一个字符串。另见
Array.prototype.join()
。
Uint8ClampedArray.prototype.keys()
返回
Array Iterator
包含数组中每个索引的键的新键。另见
Array.prototype.keys()
。
Uint8ClampedArray.prototype.lastIndexOf()
返回数组中等于指定值的元素的最后一个(最大)索引,如果没有找到,则返回-1。另见
Array.prototype.lastIndexOf()
。
Uint8ClampedArray.prototype.map()
创建一个新的数组,并在该数组中的每个元素上调用一个提供的函数的结果。另见
Array.prototype.map()
。
Uint8ClampedArray.prototype.move()
UnimplementedFormer的非标准版本
Uint8ClampedArray.prototype.copyWithin()
。
Uint8ClampedArray.prototype.reduce()
对累加器和数组的每个值应用一个函数(从左到右)以将其减少到单个值。另见
Array.prototype.reduce()
。
Uint8ClampedArray.prototype.reduceRight()
对累加器和数组的每个值(从右到左)应用一个函数,以将其减少为单个值。另见
Array.prototype.reduceRight()
。
Uint8ClampedArray.prototype.reverse()
颠倒数组元素的顺序 - 第一个变成最后一个,最后一个变成第一个。另见
Array.prototype.reverse()
。
Uint8ClampedArray.prototype.set()
在类型数组中存储多个值,从指定的数组读取输入值。
Uint8ClampedArray.prototype.slice()
提取数组的一部分并返回一个新的数组。另见
Array.prototype.slice()
。
Uint8ClampedArray.prototype.some()
如果此数组中至少有一个元素满足提供的测试函数,则返回true。另见
Array.prototype.some()
。
Uint8ClampedArray.prototype.sort()
对数组中的元素进行排序并返回数组。另见
Array.prototype.sort()
。从给定的开始和结束元素索引中
Uint8ClampedArray.prototype.subarray()
返回一个新
Uint8ClampedArray
的。
Uint8ClampedArray.prototype.values()
返回
Array Iterator
包含数组中每个索引值的新对象。另见
Array.prototype.values()
。
Uint8ClampedArray.prototype.toLocaleString()
返回表示数组及其元素的本地化字符串。另见
Array.prototype.toLocaleString()
。
Uint8ClampedArray.prototype.toString()
返回表示数组及其元素的字符串。另见
Array.prototype.toString()
。
Uint8ClampedArray.prototype[@@iterator]()
返回一个新的
Array Iterator
包含数组中每个索引值的对象。
示例
不同的方式来创建一个
Uint8ClampedArray
:
// From a length
var uintc8 = new Uint8ClampedArray(2);
uintc8[0] = 42;
uintc8[1] = 1337;
console.log(uintc8[0]); // 42
console.log(uintc8[1]); // 255 (clamped)
console.log(uintc8.length); // 2
console.log(uintc8.BYTES_PER_ELEMENT); // 1
// From an array
var arr = new Uint8ClampedArray([21,31]);
console.log(arr[1]); // 31
// From another TypedArray
var x = new Uint8ClampedArray([21, 31]);
var y = new Uint8ClampedArray(x);
console.log(y[0]); // 21
// From an ArrayBuffer
var buffer = new ArrayBuffer(8);