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

ConneyWu

1945人浏览 · 2024-07-08 16:20:57

ConneyWu · 2024-07-08 16:20:57 发布

collections.TypedArray

一种线性数据结构，底层基于ArkTS ArrayBuffer实现。目前支持包括Int8Array、Uint8Array、Int16Array、Uint16Array、Int32Array以及Uint32Array。

文档中存在泛型的使用，涉及以下泛型标记符：

TypedArray: 指上述6种具体的ArkTS TypedArray。

属性

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

名称	类型	只读	可选	说明
buffer	ArrayBuffer	是	否	ArkTS TypedArray底层使用的buffer。
byteLength	number	是	否	ArkTS TypedArray的所占的字节数。
byteOffset	number	是	否	ArkTS TypedArray距离其ArrayBuffer起始位置的偏移。
length	number	是	否	ArkTS TypedArray元素个数。
BYTES_PER_ELEMENT	number	是	否	ArkTS TypedArray中每个元素所占用的字节数。

constructor

constructor()

构造函数，用于创建一个空ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

错误码：

错误码ID	错误信息
10200012	The TypedArray's constructor cannot be directly invoked.

示例：


let int8Array: collections.Int8Array = new collections.Int8Array();
let uint8Array: collections.Uint8Array = new collections.Uint8Array();
let int16Array: collections.Int16Array = new collections.Int16Array();
let uint16Array: collections.Uint16Array = new collections.Uint16Array();
let int32Array: collections.Int32Array = new collections.Int32Array();
let uint32Array: collections.Uint32Array = new collections.Uint32Array();

constructor

constructor(length: number)

构造函数，用于创建一个指定长度的ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
length	number	是	用于指定ArkTS TypedArray的长度。

错误码：

错误码ID	错误信息
10200012	The TypedArray's constructor cannot be directly invoked.

示例：


// 以长度参数构造对象
let int8Array: collections.Int8Array = new collections.Int8Array(12);
let uint8Array: collections.Uint8Array = new collections.Uint8Array(12);
let int16Array: collections.Int16Array = new collections.Int16Array(12);
let uint16Array: collections.Uint16Array = new collections.Uint16Array(12);
let int32Array: collections.Int32Array = new collections.Int32Array(12);
let uint32Array: collections.Uint32Array = new collections.Uint32Array(12);

constructor

constructor(array: ArrayLike<number> | ArrayBuffer)

构造函数，以ArrayLike或ArkTS ArrayBuffer创建一个ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
array	ArrayLike<number> \| ArrayBuffer	是	用于构造ArkTS TypedArray的对象。当参数类型是ArrayBuffer时buffer所占的字节数须是4的整数倍。

错误码：

错误码ID	错误信息
10200012	The TypedArray's constructor cannot be directly invoked.

示例：


// 例1 从一个ArrayLike构造对象
let arrayLike = [1, 3, 5];
let array: collections.Uint32Array = new collections.Uint32Array(arrayLike);

// 例2 从一个ArrayBuffer构造对象
let arrayBuffer: collections.ArrayBuffer = new collections.ArrayBuffer(12);
let array: collections.Uint32Array = new collections.Uint32Array(arrayBuffer);

// 例3 从另一ArkTS TypedArray构造对象
let arrayLike = [1, 3, 5];
let uint8Array: collections.Uint8Array = new collections.Uint8Array(arrayLike);
// Uint8Array [1, 3, 5]
let uint32Array: collections.Uint32Array = new collections.Uint32Array(uint8Array);
// Uint32Array [1, 3, 5]

constructor

constructor(buffer: ArrayBuffer, byteOffset?: number, length?: number)

构造函数，以ArrayBuffer创建一个ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
buffer	ArrayBuffer	是	用于构造ArkTS TypedArray的ArrayBuffer对象。buffer所占的字节数须是4的整数倍。
byteOffset	number	否	指定buffer的字节偏移，默认为0。
length	number	否	指定ArkTS TypedArray的长度，默认为0。

错误码：

错误码ID	错误信息
10200012	The TypedArray's constructor cannot be directly invoked.

示例：


let int32Array: collections.Int32Array = collections.Int32Array.from([1, 2, 3, 4, 5, 6]);
console.info("byteLength: " + int32Array.buffer.byteLength) // byteLength: 24
// 从int32Array对应buffer第4个字节开始，长度为5
let uint32Array: collections.Uint32Array = new collections.Uint32Array(int32Array.buffer, 4, 5);
console.info("[" + uint32Array + "]"); // [2, 3, 4, 5, 6]

from

static from(arrayLike: ArrayLike<number>): TypedArray

从一个ArrayLike或者可迭代对象中创建一个ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
arrayLike	ArrayLike<number>	是	用于构造ArkTS TypedArray的ArrayLike对象。

返回值：

类型	说明
TypedArray	新创建的ArkTS TypedArray对象。

示例：


let arrayLike = [1, 3, 5];
let array: collections.Uint32Array = collections.Uint32Array.from(arrayLike);
// Uint32Array [1, 3, 5]

from

static from<T>(arrayLike: ArrayLike<T>, mapFn: TypedArrayFromMapFn<T, number>): TypedArray

从一个ArrayLike中创建一个ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
arrayLike	ArrayLike<T>	是	用于构造ArrayLike对象。
mapFn	TypedArrayFromMapFn<T, number>	是	映射函数。

返回值：

类型	说明
TypedArray	新创建的ArkTS TypedArray对象。

示例：


// 例1 从一个对象创建
let array: collections.Uint32Array = collections.Uint32Array.from<number>(
{ length: 5 }, (v: Object, k: number) => k);
// Uint32Array [0, 1, 2, 3, 4]

// 例2 从一个字符数组创建
let array: collections.Uint32Array = collections.Uint32Array.from<string>(
["1", "3", "5"], (v: string, k: number) => parseInt(v));
// Uint32Array [1, 3, 5]

// 例3 从一个字符串创建
let array: collections.Uint32Array = collections.Uint32Array.from<string>(
"12345", (v: string, k: number) => parseInt(v));
// Uint32Array [1, 2, 3, 4, 5]

from

static from(iterable: Iterable<number>, mapFn?: TypedArrayFromMapFn<number, number>): TypedArray

从一个可迭代对象中创建一个ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
iterable	Iterable<number>	是	用于构造的可迭代对象。
mapFn	TypedArrayFromMapFn<number, number>	否	映射函数。如果省略，则不对元素进行加工处理。

返回值：

类型	说明
TypedArray	新创建的ArkTS TypedArray对象。

示例：

// 例1 不指定映射函数
let set: Set<number> = new Set<number>([1, 2, 3]);
let array: collections.Uint32Array = collections.Uint32Array.from(set);
// Uint32Array [1, 2, 3]

// 例2 指定映射函数
let set: Set<number> = new Set<number>([1, 2, 3]);
let array: collections.Uint32Array = collections.Uint32Array.from(
set, (v: number, k: number) => v + k);
// Uint32Array [1, 3, 5]

copyWithin

copyWithin(target: number, start: number, end?: number): TypedArray

从ArkTS TypedArray指定范围内的元素依次拷贝到目标位置。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
target	number	是	目标起始位置的下标。
start	number	是	源起始位置下标，如果start < 0，则会从start + typedarray.length位置开始。
end	number	否	源终止位置下标，如果end < 0，则会从end + typedarray.length位置终止。默认为ArkTS TypedArray的长度。

返回值：

类型	说明
TypedArray	修改后的TypedArray。

错误码：

错误码ID	错误信息
10200011	The copyWithin method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5, 6, 7, 8]);
let copied: collections.Uint32Array = array.copyWithin(3, 1, 3);
// Uint32Array [1, 2, 3, 2, 3, 6, 7, 8]

some

some(predicate: TypedArrayPredicateFn<number, TypedArray>): boolean

测试ArkTS TypedArray中的是否存在元素满足指定条件。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
predicate	TypedArrayPredicateFn<number, TypedArray>	是	用于测试的断言函数。

返回值：

类型	说明
boolean	如果存在元素满足指定条件返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID	错误信息
10200011	The some method cannot be bound.
10200201	Concurrent modification exception.

示例：


let arrayLike = [-10, 20, -30, 40, -50];
let uint32Array: collections.Uint32Array = new collections.Uint32Array(arrayLike);
uint32Array.some((element: number) => element < 0); // false

let int32Array: collections.Int32Array = new collections.Int32Array(arrayLike);
int32Array.some((element: number) => element < 0); // true

every

every(predicate: TypedArrayPredicateFn<number, TypedArray>): boolean

测试ArkTS TypedArray中的所有元素是否满足指定条件。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
predicate	TypedArrayPredicateFn<number, TypedArray>	是	用于测试的断言函数。

返回值：

类型	说明
boolean	如果所有元素都满足指定条件则返回true，否则返回false。

错误码：

错误码ID	错误信息
10200011	The every method cannot be bound.
10200201	Concurrent modification exception.

示例：


let arrayLike = [-10, 20, -30, 40, -50];
let uint32Array: collections.Uint32Array = new collections.Uint32Array(arrayLike);
uint32Array.every((element: number) => element > 0); // true

let int32Array: collections.Int32Array = new collections.Int32Array(arrayLike);
int32Array.every((element: number) => element > 0); // false

fill

fill(value: number, start?: number, end?: number): TypedArray

使用特定值填充ArkTS TypedArray指定范围的全部元素。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
value	number	是	待填充的值。
start	number	否	开始填充的索引，如果start < 0，则会从start + typedarray.length位置开始。默认值为0。
end	number	否	结束填充的索引，如果end < 0，则会到end + typedarray.length位置结束。默认为ArkTS TypedArray的长度。

返回值：

类型	说明
TypedArray	填充后的TypedArray。

错误码：

错误码ID	错误信息
10200011	The fill method cannot be bound.
10200201	Concurrent modification exception.

示例：


let arrayLike = [1, 2, 3];
new collections.Uint32Array(arrayLike).fill(4); // Uint32Array [4, 4, 4]
new collections.Uint32Array(arrayLike).fill(4, 1); // Uint32Array [1, 4, 4]
new collections.Uint32Array(arrayLike).fill(4, 1, 2); // Uint32Array [1, 4, 3]

filter

filter(predicate: TypedArrayPredicateFn<number, TypedArray>): TypedArray

返回一个新ArkTS TypedArray，其包含满足指定条件的所有元素。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
predicate	TypedArrayPredicateFn<number, TypedArray>	是	用于元素过滤的断言函数。

返回值：

类型	说明
TypedArray	过滤后的ArkTS TypedArray对象。

错误码：

错误码ID	错误信息
10200011	The filter method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([0, 1, 2, 3, 4]);
let filtered: collections.Uint32Array = array.filter((element: number) => element % 2 == 0);
// Uint32Array [0, 2, 4]

find

find(predicate: TypedArrayPredicateFn<number, TypedArray>): number | undefined

返回ArkTS TypedArray中第一个满足指定条件的元素的值，如果所有元素都不满足，则返回undefined。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
predicate	TypedArrayPredicateFn<number, TypedArray>	是	用于元素查找的断言函数。

返回值：

类型	说明
number \| undefined	第一个满足条件的元素的值；如果所有元素都不满足条件，则返回undefined。

错误码：

错误码ID	错误信息
10200011	The find method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([0, 1, 2, 3, 4]);
array.find((element: number) => element > 2); // 3
array.find((element: number) => element > 4); // undefined

findIndex

findIndex(predicate: TypedArrayPredicateFn<number, TypedArray>): number

返回ArkTS TypedArray中第一个满足指定条件的元素索引，如果所有元素都不满足，则返回-1。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
predicate	TypedArrayPredicateFn<number, TypedArray>	是	用于元素查找的断言函数。

返回值：

类型	说明
number	第一个满足条件的元素索引；如果所有元素都不满足条件，否返回-1。

错误码：

错误码ID	错误信息
10200011	The findIndex method cannot be bound.
10200201	Concurrent modification exception.

示例：


const array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let foundIndex: number = array.findIndex((element: number) => element % 2 === 0); // 1

forEach

forEach(callbackFn: TypedArrayForEachCallback<number, TypedArray>): void

对ArkTS TypedArray中的每个元素执行提供的回调函数。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
callbackFn	TypedArrayForEachCallback<number, TypedArray>	是	用于对每个元素执行的回调函数。

错误码：

错误码ID	错误信息
10200011	The forEach method cannot be bound.
10200201	Concurrent modification exception.

示例：


let uint32Array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3]);
uint32Array.forEach((value: number, index: number, array: collections.Uint32Array) => {
console.info(`Element ${value} at index ${index}`);
});

indexOf

indexOf(searchElement: number, fromIndex?: number): number

返回在ArkTS TypedArray中给定元素的第一个索引，如果不存在，则返回-1。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
searchElement	number	是	待索引的值。
fromIndex	number	否	搜索的起始下标。默认值为0。如果下标大于等于ArkTS TypedArray的长度，则返回-1。如果提供的下标值是负数，则被当做距离数组尾部的偏移，从前到后搜索。

返回值：

类型	说明
number	数组中元素的第一个索引；没有找到，则返回-1。

错误码：

错误码ID	错误信息
10200011	The indexOf method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([3, 5, 9]);
array.indexOf(3); // 0
array.indexOf(7); // -1
array.indexOf(9, 2); // 2
array.indexOf(9, -2); // 2

join

join(separator?: string): string

将ArkTS TypedArray的所有元素拼接成一个字符串，元素之间使用指定的分隔符分隔。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
separator	string	否	分隔字符串。如果省略，则使用逗号分隔。

返回值：

类型	说明
string	包含所有元素拼接成的字符串。如果ArkTS TypedArray为空，则返回空字符串。

错误码：

错误码ID	错误信息
10200011	The join method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let joined: string = array.join('-'); // "1-2-3-4-5"

map

map(callbackFn: TypedArrayForEachCallback<number, TypedArray>): TypedArray

对ArkTS TypedArray中的每个元素应用指定的回调函数，并使用结果创建一个新的ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
callbackFn	TypedArrayForEachCallback<number, TypedArray>	是	回调函数。

返回值：

类型	说明
TypedArray	新ArkTS TypedArray对象。

错误码：

错误码ID	错误信息
10200011	The map method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([25, 36, 49]);
const mapped: collections.Uint32Array = array.map(Math.sqrt); // Uint32Array [5, 6 ,7]

reduce

reduce(callbackFn: TypedArrayReduceCallback<number, number, TypedArray>): number

对ArkTS TypedArray中的每个元素执行归约函数，并返回最终的归约结果。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
callbackFn	TypedArrayReduceCallback<number, number, TypedArray>	是	归约函数。

返回值：

类型	说明
number	由归约函数返回的结果。

错误码：

错误码ID	错误信息
10200011	The reduce method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let reducedValue: number = array.reduce((accumulator: number, value: number) => accumulator + value);
// reducedValue == 15

reduce

reduce(callbackFn: TypedArrayReduceCallback<number, number, TypedArray>, initialValue: number): number

对ArkTS TypedArray中的每个元素执行归约函数，且接收一个初始值作为归约函数首次调用的参数，并返回最终的归约结果。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
callbackFn	TypedArrayReduceCallback<number, number, TypedArray>	是	归约函数。
initialValue	number	是	初始值。

返回值：

类型	说明
number	由归约函数返回的结果。

错误码：

错误码ID	错误信息
10200011	The reduce method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let reducedValue: number = array.reduce((accumulator: number, value: number) => accumulator + value, 1);
// reducedValue == 16

reduce

reduce<U>(callbackFn: TypedArrayReduceCallback<U, number, TypedArray>, initialValue: U): U

对ArkTS TypedArray中的每个元素执行归约函数，且接收一个初始值作为归约函数首次调用的参数，并返回最终的归约结果。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
callbackFn	TypedArrayReduceCallback<U, number, TypedArray>	是	归约函数。
initialValue	U	是	初始值。

返回值：

类型	说明
U	由归约函数返回的结果。

错误码：

错误码ID	错误信息
10200011	The reduce method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let reducedValue: string = array.reduce<string>((accumulator: string, value: number) => accumulator + value, "initialValue");
// reducedValue == initialValue12345

reverse

reverse(): TypedArray

反转ArkTS TypedArray。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

返回值：

类型	说明
TypedArray	反转后的ArkTS TypedArray对象。

错误码：

错误码ID	错误信息
10200011	The reverse method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let reversed: collections.Uint32Array = array.reverse(); // Uint32Array [5, 4, 3, 2, 1]

set

set(array: ArrayLike<number>, offset?: number): void

将传入的ArrayLike元素依次写入到指定的起始位置。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
array	ArrayLike<number>	是	用于设置的ArrayLike对象。
offset	number	否	写入的起始位置。默认为0。

错误码：

错误码ID	错误信息
10200011	The set method cannot be bound.
10200201	Concurrent modification exception.

示例：


let buffer: collections.ArrayBuffer = new collections.ArrayBuffer(8);
let array: collections.Uint8Array = new collections.Uint8Array(buffer);
array.set([1, 2, 3], 3); // Uint8Array [0, 0, 0, 1, 2, 3, 0, 0]

slice

slice(start?: number, end?: number): TypedArray

返回一个新的ArkTS TypedArray对象，其包含原ArkTS TypedArray指定范围的内容。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
start	number	否	开始索引，如果start < 0，则会从start + typedarray.length位置开始。默认为0。
end	number	否	结束索引（不包括该元素），如果end < 0，则会到end + typedarray.length位置结束。默认为ArkTS TypedArray的长度。

返回值：

类型	说明
TypedArray	新的ArkTS TypedArray对象。

错误码：

错误码ID	错误信息
10200011	The slice method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
array.slice(); // Uint32Array [1, 2, 3, 4, 5]
array.slice(1, 3); // Uint32Array [2, 3]
array.slice(-2); // Uint32Array [4, 5]

sort

sort(compareFn?: TypedArrayCompareFn<number>): TypedArray

对ArkTS TypedArray进行排序，并返回排序后的ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
compareFn	TypedArrayCompareFn<number>	否	用于确定元素顺序的函数。默认使用升序排序。

返回值：

类型	说明
TypedArray	排序后的ArkTS TypedArray对象。

错误码：

错误码ID	错误信息
10200011	The sort method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 3, 5, 4, 2]);
array.sort(); // Uint32Array [1, 2, 3, 4, 5]
array.sort((a: number, b: number) => a - b); // Uint32Array [1, 2, 3, 4, 5]
array.sort((a: number, b: number) => b - a); // Uint32Array [5, 4, 3, 2, 1]

subarray

subarray(begin?: number, end?: number): TypedArray

返回一个新的、基于相同ArkTS ArrayBuffer的ArkTS TypedArray对象。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
begin	number	否	开始索引，如果begin < 0，则会从begin + typedarray.length位置开始。默认值为0。
end	number	否	结束索引（不包括该元素），如果end < 0，则会到end + typedarray.length位置结束。默认为ArkTS TypedArray的长度。

返回值：

类型	说明
TypedArray	新的ArkTS TypedArray对象。

错误码：

错误码ID	错误信息
10200011	The subarray method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let subArray: collections.Uint32Array = array.subarray(); // Uint32Array [1, 2, 3, 4, 5]
subArray.set([10, 20, 30]); // Uint32Array [10, 20, 30, 4, 5]

at

at(index: number): number | undefined

返回指定下标的元素，如果不存在，则返回undefined。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
index	number	是	要返回的Array元素的索引（从零开始），取值为整数。如果index < 0，则会访问index + typedarray.length位置的元素。

返回值：

类型	说明
number \| undefined	指定下标的元素；如果不存在，则返回undefined。

错误码：

错误码ID	错误信息
10200011	The at method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
console.info("element: " + array.at(2)); // element: 3
console.info("element: " + array.at(-1)); // element: 5
console.info("element: " + array.at(6)); // element: undefined

includes

includes(searchElement: number, fromIndex?: number): boolean

判断ArkTS TypedArray是否包含特定元素。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

参数名	类型	必填	说明
searchElement	number	是	待搜索的元素。
fromIndex	number	否	开始搜索的索引，如果fromIndex < 0，则会从fromIndex + typedarray.length位置开始。默认值为0。

返回值：

类型	说明
boolean	如果ArkTS TypedArray包含指定的元素，则返回true；否则返回false。

错误码：

错误码ID	错误信息
10200011	The includes method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3]);
console.info("includes: " + array.includes(2)); // includes: true
console.info("includes: " + array.includes(4)); // includes: false
console.info("includes: " + array.includes(3, 3)); // includes: false

entries

entries(): IterableIterator<[number, number]>

返回一个新的迭代器对象，该对象包含ArkTS TypedArray中每个元素的键值对。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

返回值：

类型	说明
IterableIterator<[number, number]>	新的迭代器对象。

错误码：

错误码ID	错误信息
10200011	The entries method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([11, 22, 33]);
let iterator: IterableIterator<[number, number]> = array.entries();
console.info("value: " + iterator.next().value); // value: [0, 11]
console.info("value: " + iterator.next().value); // value: [1, 22]
console.info("value: " + iterator.next().value); // value: [2, 33]

keys

keys(): IterableIterator<number>

返回一个新的迭代器对象，该对象包含ArkTS TypedArray中每个元素的键（下标）。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

返回值：

类型	说明
IterableIterator<number>	新的迭代器对象。

错误码：

错误码ID	错误信息
10200011	The keys method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let iterator: IterableIterator<number> = array.keys();
for (const key of iterator) {
console.info("" + key); // 依次输出 0,1,2,3,4
}

values

values(): IterableIterator<number>

返回一个新的迭代器对象，该对象包含ArkTS TypedArray中每个元素的值。

系统能力： SystemCapability.Utils.Lang

元服务API： 从API version 12开始，该接口支持在元服务中使用。

返回值：

类型	说明
IterableIterator<number>	新的迭代器对象。

错误码：

错误码ID	错误信息
10200011	The values method cannot be bound.
10200201	Concurrent modification exception.

示例：


let array: collections.Uint32Array = collections.Uint32Array.from([1, 2, 3, 4, 5]);
let iterator: IterableIterator<number> = array.values();
for (const value of iterator) {
console.info("" + value); // 依次输出 1,2,3,4,5
}

HarmonyOS开发者社区

讨论HarmonyOS开发技术，专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐

灯光模拟HarmonyOS应用实战-27-两千道生成题为什么正确答案全是B：用稳定置换消除答案位置偏置

HarmonyOS开发者社区

深色模式：ResourceManager 如何选资源及如何手动控制

"深色模式一切全系统跟着变"是 HarmonyOS 的默认行为——ResourceManager 根据系统 colorMode 自动选择 resources/dark/element/color.json 里的深色资源。但很多场景需要"应用内不跟随系统"或"单个页面固定浅色"。本文讲清自动选择的原理，以及如何用 Configuration 手动控制深浅色。

HarmonyOS开发者社区

HarmonyOS 长列表滚动卡顿与图片懒加载优化实战

在 HarmonyOS 应用里，长列表（List / WaterFlow / Grid）是最常见的页面形态，也是性能问题的高发区。社区里两类高频提问很有代表性：一是"列表滚到底图片要等 700ms 才展示"，二是"上拉加载次数越多，列表越卡"。这两个现象看似独立，本质都指向同一个问题——渲染与数据追加没有做对。本文结合 ArkUI 的渲染机制，给出可落地的优化方案与验证方法。