collections.ArrayBuffer
ArkTS TypedArray的底层数据结构。
属性
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
名称 | 类型 | 只读 | 可选 | 说明 |
---|---|---|---|---|
byteLength | number | 是 | 否 | buffer所占的字节数。 |
constructor
constructor(byteLength: number)
构造函数,用于创建一个指定长度的ArkTS ArrayBuffer对象。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
byteLength | number | 是 | buffer所占的字节数。 |
错误码:
错误码ID | 错误信息 |
---|---|
10200012 | The ArrayBuffer's constructor cannot be directly invoked. |
示例:
let arrayBuffer: collections.ArrayBuffer = new collections.ArrayBuffer(10);
console.info("byteLength: " + arrayBuffer.byteLength); // byteLength: 10
slice
slice(begin: number, end?: number): ArrayBuffer
返回一个新的ArkTS ArrayBuffer对象,其包含原ArkTS ArrayBuffer指定范围的内容。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
begin | number | 是 | 开始索引,如果begin < 0,则会从begin + arraybuffer.byteLength位置开始。 |
end | number | 否 | 结束索引(不包括该元素),如果end < 0,则会到end + arraybuffer.byteLength位置结束。默认为ArkTS ArrayBuffer的长度。 |
返回值:
类型 | 说明 |
---|---|
ArrayBuffer | 新的ArkTS ArrayBuffer对象。 |
错误码:
错误码ID | 错误信息 |
---|---|
10200011 | The slice method cannot be bound. |
10200201 | Concurrent modification error. |
示例:
let arrayBuffer: collections.ArrayBuffer = new collections.ArrayBuffer(10);
let slicedBuffer: collections.ArrayBuffer = arrayBuffer.slice(0, 4);
console.info("byteLength: " + slicedBuffer.byteLength); // byteLength: 4
TypedArrayFromMapFn
type TypedArrayFromMapFn<FromElementType, ToElementType> = (value: FromElementType, index: number) => ToElementType
ArkTS TypedArray映射函数类型。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | FromElementType | 是 | 当前遍历的用于构造ArkTS TypedArray的元素。 |
index | number | 是 | 当前遍历的用于构造ArkTS TypedArray的元素下标。 |
TypedArrayPredicateFn
type TypedArrayPredicateFn<ElementType, ArrayType> = (value: ElementType, index: number, array: ArrayType) => boolean
ArkTS TypedArray断言测试函数类型。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | ElementType | 是 | 当前遍历的ArkTS TypedArray元素。 |
index | number | 是 | 当前遍历的ArkTS TypedArray元素下标。 |
array | ArrayType | 是 | 当前遍历的ArkTS TypedArray实例。 |
TypedArrayForEachCallback
type TypedArrayForEachCallback<ElementType, ArrayType> = (value: ElementType, index: number, array: ArrayType) => void
ArkTS TypedArray遍历函数类型。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | ElementType | 是 | 当前遍历的ArkTS TypedArray元素。 |
index | number | 是 | 当前遍历的ArkTS TypedArray元素下标。 |
array | ArrayType | 是 | 当前遍历的ArkTS TypedArray实例。 |
TypedArrayReduceCallback
type TypedArrayReduceCallback<AccType, ElementType, ArrayType> = (previousValue: AccType, currentValue: ElementType, currentIndex: number, array: ArrayType) => AccType
ArkTS TypedArray归约函数类型。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
previousValue | AccType | 是 | 当前遍历所累积的值。 |
currentValue | ElementType | 是 | 当前遍历的ArkTS TypedArray元素。 |
currentIndex | number | 是 | 当前遍历的ArkTS TypedArray元素下标。 |
array | ArrayType | 是 | 当前遍历的ArkTS TypedArray实例。 |
TypedArrayCompareFn
type TypedArrayCompareFn<ElementType> = (first: ElementType, second: ElementType) => number
ArkTS TypedArray排序函数类型。
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 12开始,该接口支持在元服务中使用。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
first | ElementType | 是 | 当前待比较的第一个元素。 |
second | ElementType | 是 | 当前待比较的第二个元素。 |