【HarmonyOS NEXT】鸿蒙线程安全容器集collections.ArrayBuffer

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实例。