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

最新推荐文章于 2024-10-21 15:39:06 发布
最新推荐文章于 2024-10-21 15:39:06 发布
阅读量1.8k 收藏 22
点赞数 29
分类专栏： harmony 文章标签： 安全 harmonyos 鸿蒙 线程安全
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wu1004019946/article/details/140270389
版权

导入模块

import { collections } from '@kit.ArkTS';

ISendable

type ISendable = lang.ISendable

ISendable是所有Sendable类型（除null和undefined）的父类型。自身没有任何必须的方法和属性。

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

系统能力： SystemCapability.Utils.Lang

类型说明
lang.ISendable所有Sendable类型的父类型。

collections.ConcatArray

表示可以进行连接的类似数组的对象。该接口扩展了ISendable接口。

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

  • T：Type，支持Sendable的数据类型。

属性

系统能力： SystemCapability.Utils.Lang

名称类型只读可选说明
lengthnumber是否ConcatArray的元素个数。

join

join(separator?: string): string

将ConcatArray的所有元素连接成一个字符串，元素之间可以用指定的分隔符分隔。

系统能力： SystemCapability.Utils.Lang

参数：

参数名类型必填说明
separatorstring否用于分隔ConcatArray元素的字符串。如果省略，则使用逗号分隔。

返回值：

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

错误码：

错误码ID错误信息
401Parameter error. Invalid separator.

示例：

let concatArray : collections.ConcatArray<string> = new collections.Array<string>('a', 'b', 'c');
let joinedString = concatArray.join('-'); // 返回 "a-b-c"

slice

slice(start?: number, end?: number): ConcatArray<T>

返回一个新的ConcatArray，该ConcatArray是原始ConcatArray的切片。

系统能力： SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
ConcatArray<T>包含原始ConcatArray切片的新ConcatArray。

错误码：

错误码ID错误信息
401Parameter error. Invalid start or end parameters.

示例：

let concatArray : collections.ConcatArray<number> = new collections.Array<number>(1, 2, 3, 4, 5);
let slicedArray = concatArray.slice(1, 3); // 返回[2, 3]，原Array保持不变

collections.Array

一种线性数据结构，底层基于数组实现，可以在ArkTS上并发实例间传递。

当需要在ArkTS上并发实例间传递Array时，可以通过传递Array引用提升传递性能。

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

  • T：Type，支持​​​​​​​Sendable的数据类型。

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

属性

系统能力： SystemCapability.Utils.Lang

名称类型只读可选说明
lengthnumber是否Array的元素个数。

constructor

构造函数

constructor()

创建一个ArkTS Array的构造函数。

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

系统能力： SystemCapability.Utils.Lang

错误码：

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

示例：

 

  1. let array = new collections.Array<number>();
 

constructor
 

constructor(first: T, ...left: T[])
 

ArkTS Array的构造函数，通过开发者提供的元素进行初始化。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
firstT是初始化ArkTS Array的第一个元素。
leftT[]否初始化ArkTS Array的剩余元素。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4);
 

create
 

static create<T>(arrayLength: number, initialValue: T): Array<T>
 

生成一个固定长度的Array，其中，每个元素的初始值为initialValue。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
arrayLengthnumber是用于构造ArkTS Array的长度。
initialValueT是用于填充ArkTS Array的值。
 

返回值：
 

类型说明
Array<T>新创建的ArkTS Array实例。
 

错误码：
 

错误码ID错误信息
10200011The create method cannot be bound.
 

示例：
 

let array = collections.Array.create<number>(3, 10); // [10, 10, 10]
 

from
 

static from<T>(arrayLike: ArrayLike<T>): Array<T>
 

从一个实现了ArrayLike接口的对象创建一个新的ArkTS Array。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
arrayLikeArrayLike<T>是用于构造ArkTS Array的对象。
 

返回值：
 

类型说明
Array<T>新创建的ArkTS Array实例。
 

错误码：
 

错误码ID错误信息
10200011The from method cannot be bound.
 

示例：
 

// 正例
let array : Array<string> = ['str1', 'str2', 'str3']; // 原生Array<T>，T是Sendable数据类型。
let sendableArray = collections.Array.from<string>(array); // 返回Sendable Array<T>

// 反例
let array : Array<Array<string>> = [['str1', 'str2', 'str3'], ['str4', 'str5', 'str6'], ['str7', 'str8', 'str9']]; // 原生Array<T>，T是非Sendable数据类型。
let sendableArray = collections.Array.from<Array<string>>(array); // 打印异常信息：Parameter error.Only accept sendable value
 

pop
 

pop(): T | undefined
 

从ArkTS Array中移除并返回最后一个元素。如果Array为空，则返回undefined，且Array不发生变化。
 

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

系统能力： SystemCapability.Utils.Lang
 

返回值：
 

类型说明
T | undefined从Array中移除的元素；如果Array为空，则返回undefined。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3);
let lastElement = array.pop(); // 返回3，Array变为[1, 2]
 

push
 

push(...items: T[]): number
 

在ArkTS Array的末尾添加一个或多个元素，并返回新的Array长度。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
itemsT[]是要添加到Array末尾的一个或多个元素。
 

返回值：
 

类型说明
number返回新Array的长度。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3);
let length = array.push(4, 5); // 返回5，Array变为[1, 2, 3, 4, 5]
 

join
 

join(separator?: string): string
 

将ArkTS Array的所有元素连接成一个字符串，元素之间可以用指定的分隔符分隔。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
separatorstring否用于分隔Array元素的字符串。如果省略，则使用逗号分隔。
 

返回值：
 

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

错误码：
 

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

示例：
 

let array = new collections.Array<string>('a', 'b', 'c');
let joinedString = array.join('-'); // 返回 "a-b-c"
 

shift
 

shift(): T | undefined
 

从ArkTS Array中移除并返回第一个元素。如果Array为空，则返回undefined，且Array不发生变化。
 

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

系统能力： SystemCapability.Utils.Lang
 

返回值：
 

类型说明
T | undefined从Array中移除的元素；如果Array为空，则返回undefined。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3);
let firstElement = array.shift(); // 返回1，Array变为[2, 3]
 

unshift
 

unshift(...items: T[]): number
 

在ArkTS Array的首端插入一个或多个元素，并返回新的Array长度。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
itemsT[]是要插入到Array首端的元素。
 

返回值：
 

类型说明
number新Array的长度。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3);
let newLength = array.unshift(0); // 返回4，Array变为[0, 1, 2, 3]
 

slice
 

slice(start?: number, end?: number): Array<T>
 

返回一个新的Array，该Array是原始ArkTS Array的切片。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

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

返回值：
 

类型说明
Array<T>包含原始Array切片的新Array。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let slicedArray = array.slice(1, 3); // 返回[2, 3]，Array保持不变
 

sort
 

sort(compareFn?: (a: T, b: T) => number): Array<T>
 

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

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
compareFn(a: T, b: T) => number否用于确定元素顺序的函数。默认使用升序排序。
 

返回值：
 

类型说明
Array<T>排序后的Array。
 

错误码：
 

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

示例：
 

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

indexOf
 

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

返回在ArkTS Array中搜索元素首次出现的索引，如果不存在则返回-1。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
searchElementT是要搜索的值。
fromIndexnumber否开始搜索的索引。默认值为0。
 

返回值：
 

类型说明
number搜索元素首次出现的索引；如果不存在，则返回-1。
 

错误码：
 

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

示例：
 

let array = new collections.Array<string>('a', 'b', 'c');
let index = array.indexOf('b'); // 返回1，因为'b'在索引1的位置
 

forEach
 

forEach(callbackFn: (value: T, index: number, array: Array<T>) => void): void
 

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

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
callbackFn(value: T, index: number, array: Array<T>) => void是用于对每个元素执行的回调函数。
 

错误码：
 

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

示例：
 

let array = new collections.Array<string>('a', 'b', 'c');
array.forEach((value, index, array) => {
console.info(`Element ${value} at index ${index}`);
});
 

map
 

map<U>(callbackFn: (value: T, index: number, array: Array<T>) => U): Array<U>
 

对Array中的每个元素执行提供的回调函数，并返回一个新的Array，该Array包含回调函数的结果。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
callbackFn(value: T, index: number, array: Array<T>) => U是用于对每个元素执行的回调函数。
 

返回值：
 

类型说明
Array<U>包含回调函数结果的新Array。
 

错误码：
 

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

示例：
 

// 此处将原始Array中的每个字符串元素转换为大写形式，并返回一个新Array，其中包含转换后的字符串
let array = new collections.Array<string>('a', 'b', 'c');
let mappedArray = array.map((value, index, array) => {
return value.toUpperCase(); // 将每个字符串元素转换为大写
});
console.info("" + mappedArray); // 输出: ['A', 'B', 'C']
 

filter
 

filter(predicate: (value: T, index: number, array: Array<T>) => boolean): Array<T>
 

返回一个新Array，其中包含通过指定回调函数测试的所有元素。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
predicate(value: T, index: number, array: Array<T>) => boolean是一个接受三个参数的函数，用于测试每个元素是否应该包含在新Array中。
 

返回值：
 

类型说明
Array<T>包含通过测试的元素的新Array。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let filteredArray = array.filter((value : number) => value % 2 === 0); // 返回[2, 4]，只包含偶数
 

reduce
 

reduce(callbackFn: (previousValue: T, currentValue: T, currentIndex: number, array: Array<T>) => T): T
 

对Array中的每个元素执行回调函数，将其结果作为累加值，并返回最终的结果。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
callbackFn(previousValue: T, currentValue: T, currentIndex: number, array: Array<T>) => T是一个接受四个参数的函数，用于对每个元素执行操作，并将结果作为累加值传递给下一个元素。
 

返回值：
 

类型说明
T回调函数执行后的最终结果。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let reducedValue = array.reduce((accumulator, value) => accumulator + value); // 返回15，累加所有元素
 

reduce
 

reduce<U>(callbackFn: (previousValue: U, currentValue: T, currentIndex: number, array: Array<T>) => U, initialValue: U): U
 

与 reduce方法类似，但它接受一个初始值作为第二个参数，用于在Array遍历开始前初始化累加器。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
callbackFncallbackFn: (previousValue: U, currentValue: T, currentIndex: number, array: Array<T>) => U是一个接受四个参数的函数，用于对每个元素执行操作，并将结果作为累加值传递给下一个元素。
initialValueU是用于初始化累加器的值。
 

返回值：
 

类型说明
U回调函数执行后的最终结果。
 

错误码：
 

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

示例：
 

// 此处使用一个初始值为0的累加器，并将其与Array中的每个元素相加，最终返回累加后的总和
let array = new collections.Array(1, 2, 3, 4, 5);
let reducedValue = array.reduce<number>((accumulator: number, value: number) => accumulator + value, 0); // 返回15，累加所有元素，初始值为0
 

at
 

at(index: number): T | undefined
 

返回Array中指定索引位置的元素。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

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

返回值：
 

类型说明
T | undefined返回指定索引处的元素；如果索引超出范围或无效，则返回undefined。
 

错误码：
 

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

示例：
 


let array = new collections.Array<number>(1, 2, 3, 4, 5);
let elementAtIndex = array.at(2); // 返回3，因为索引是从0开始的
 

entries
 

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

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

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

系统能力： SystemCapability.Utils.Lang
 

返回值：
 

类型说明
IterableIterator<[number, T]>包含Array中每个元素的键值对的迭代器。
 

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let iterator = array.entries();
console.info(iterator.next().value); // 输出：[0, 1]，第一个元素的键值对
 

keys
 

keys(): IterableIterator<number>
 

返回一个新的可迭代对象，该对象包含Array中每个元素的键。
 

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

系统能力： SystemCapability.Utils.Lang
 

返回值：
 

类型说明
IterableIterator<number>包含Array中每个元素的键的可迭代迭代器。
 

错误码：
 

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

示例：
 

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

values
 

values(): IterableIterator<T>
 

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

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

系统能力： SystemCapability.Utils.Lang
 

返回值：
 

类型说明
IterableIterator<T>包含Array中每个元素的值的可迭代迭代器。
 

错误码：
 

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

示例：
 

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

find
 

find(predicate: (value: T, index: number, obj: Array<T>) => boolean): T | undefined
 

返回Array中第一个满足指定测试函数的元素的值，如果所有元素都不满足，则返回undefined。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
predicate(value: T, index: number, obj: Array<T>) => boolean是一个接受三个参数的函数，用于测试每个元素是否满足条件。
 

返回值：
 

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

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let foundValue = array.find((value: number) => value % 2 === 0); // 返回2，第一个偶数元素
 

includes
 

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

判断Array是否包含指定的元素，并返回一个布尔值。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
searchElementT是要搜索的元素。
fromIndexnumber否开始搜索的索引。默认值为0。
 

返回值：
 

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

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let includesResult = array.includes(3); // 返回true，因为Array中包含3
 

findIndex
 

findIndex(predicate: (value: T, index: number, obj: Array<T>) => boolean): number
 

返回Array中第一个满足指定测试函数的元素的索引，如果所有元素都不满足，则返回-1。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
predicate(value: T, index: number, obj: Array<T>) => boolean是一个接受三个参数的函数，用于测试每个元素是否满足条件。
 

返回值：
 

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

错误码：
 

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

示例：
 

let array = new collections.Array<number>(1, 2, 3, 4, 5);
let foundIndex = array.findIndex((value: number) => value % 2 === 0); // 返回1，因为2是第一个偶数元素
 

fill
 

fill(value: T, start?: number, end?: number): Array<T>
 

使用指定的值填充Array中指定范围的所有元素。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
valueT是要填充的值。
startnumber否开始填充的索引。默认值为0。
endnumber否结束填充的索引。如果省略，则填充到Array的最后一个元素。
 

返回值：
 

类型说明
Array<T>填充后的Array。
 

错误码：
 

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

示例：
 

let array = new collections.Array(1, 2, 3, 4, 5);
array.fill(0, 1, 3); // 返回[1, 0, 0, 4, 5]，因为1到3的索引范围内的元素被替换为0
 

shrinkTo
 

shrinkTo(arrayLength: number): void
 

使Array收缩到指定长度。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
arrayLengthnumber是Array的新长度。如果arrayLength >= array.length，则Array不变。
 

错误码：
 

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

示例：
 


let array1 = new collections.Array(1, 2, 3, 4, 5);
array1.shrinkTo(1); // array内容变为：[1]

let array2 = new collections.Array(1, 2, 3, 4, 5);
array2.shrinkTo(10); // array内容不变
 

extendTo
 

extendTo(arrayLength: number, initialValue: T): void
 

使Array扩展到指定长度，扩展的部分使用给定值填充。
 

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

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
arrayLengthnumber是Array的新长度。如果arrayLength <= array.length，则Array不变。
initialValueT是扩展的部分的填充值。
 

错误码：
 

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

示例：
 

let array1 = new collections.Array(1, 2, 3);
array1.extendTo(5, 10); // array内容变为：[1, 2, 3, 10, 10]

let array2 = new collections.Array(1, 2, 3);
array2.extendTo(1, 10); // array内容不变
 

concat
 

concat(...items: ConcatArray<T>[]): Array<T>
 

拼接两个或多个数组。
 

系统能力： SystemCapability.Utils.Lang
 

参数：
 

参数名类型必填说明
itemsConcatArray<T>[]是拼接两个或多个数组。
 

返回值：
 

类型说明
Array<T>拼接后的数组。
 

错误码：
 

错误码ID错误信息
401Parameter error. Not a valid array.
10200011The concat method cannot be bound.
10200201Concurrent modification error.
 

示例：
 

let array = new collections.Array(1, 2, 3);
let array1 = new collections.Array(4, 5, 6);
let array2 = new collections.Array(7, 8, 9);

let concatArray = array.concat(array1, array2); // concatArray的内容为：[1, 2, 3, 4, 5, 6, 7, 8, 9]
 


                

        

        

    

  


    

      

        

            

              
                
                  ConneyWu
                
              
            

            

                关注
              
            

        

        

          
      

      

            

                专栏目录
          









                



	

		

			

				
					
【HarmonyOS NEXT应用开发】案例30：ArkTS多线程的多线程系列（二）：基于Sendable共享对象实现跨线程通信及UI状态刷新

				
			

			

				

					xzs51job的专栏
				

				

					08-14
					
					94
					
				

			

		

		

			
				
Step4：当子线程需要更新下载进度条数据，将下载进度设置到DownloadVideoInfo共享对象中，并给主线程发送"UPDATE_DOWNLOAD_PROGRESS"事件，主线程接收到事件后从共享对象中获取下载进度，并刷新UI。4.2 主线程通过onReceiveData接收子线程消息，当判断消息是需要更新下载进度（"UPDATE_DOWNLOAD_PROGRESS"）时，将共享对象中的下载进度赋值给状态变量，更新UI。通过Sendable构建可跨线程共享的对象DownloadVideoInfo；

			
		

	



                

            
              



	

		

			

				
					
【HarmonyOS NEXT应用开发】案例140：基于RN框架实现高性能瀑布流页面

				
			

			

				

					xzs51job的专栏
				

				

					09-08
					
					566
					
				

			

		

		

			
				
本案例针对瀑布流页面场景，基于@react-native-oh-tpl/flash-list、axios等框架，实现了一个高性能的瀑布流页面，该案例提供了关键的开发步骤，旨在帮助开发者高效开发出高性能的瀑布流页面。详情请查看。名称版本号0.72.270.0.26rnoh5.0.0.302及以上5.0.0.302及以上页面：页面渲染最大数≤300页面组件嵌套层数≤30。

			
		

	



              


  
              

                


	

		

			

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

				
			

			

				

					wu1004019946的博客
				

				

					07-08
					
					794
					
				

			

		

		

			
				
从API version 12 开始，该接口支持在元服务中使用。：从API version 12 开始，该接口支持在元服务中使用。：从API version 12 开始，该接口支持在元服务中使用。：从API version 12 开始，该接口支持在元服务中使用。：从API version 12 开始，该接口支持在元服务中使用。：从API version 12 开始，该接口支持在元服务中使用。：从API version 12 开始，该接口支持在元服务中使用。向该Map添加或更新一个指定的键值对。

			
		

	





	

		

			

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

				
			

			

				

					wu1004019946的博客
				

				

					07-08
					
					1299
					
				

			

		

		

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

			
		

	



		

			
		



	

		

			

				
					
鸿蒙(HarmonyOS)--编程语言-ArkTS 语言基础

				
			

			

				

					hqy1989的博客
				

				

					09-16
					
					2876
					
				

			

		

		

			
				
ArkTS是HarmonyOS生态的应用开发语言。ArkTS和 TS 以及 JS 的关系。

			
		

	





	

		

			

				
					
鸿蒙二进制数组创建

				
			

			

				

					2401_82772199的博客
				

				

					01-31
					
					1419
					
				

			

		

		

			
				
c++层数据都是二进制，需要转换成arrayBuffer透传到ets层给业务使用，但是鸿蒙的使用下面两个api创建出来的二进制数组数据都是错误的。

			
		

	





	

		

			

				
					
鸿蒙TypeScript入门学习第11天【Array(数组)】

				
			

			

				

					鸿蒙的技术博客
				

				

					04-09
					
					3386
					
				

			

		

		

			
				
数组对象是使用单独的变量名来存储一系列的值。数组非常常用。这样看起来就简洁多了。如果数组声明时未设置类型，则会被认为是 any 类型，在初始化时根据第一个元素的类型来推断数组的类型。

			
		

	





	

		

			

				
					
鸿蒙语言基础类库：【@ohos.util.ArrayList (线性容器ArrayList)】

				
			

			

				

					2301_76813281的博客
				

				

					07-09
					
					1349
					
				

			

		

		

			
				
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。点击或者复制转到。ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。ArrayList和[Vector]相似，都是基于数组实现。它们都可以动态调整容量，但Vector每次扩容增加1倍。ArrayList和[LinkedList]相比，ArrayList的随机访问效率更高。

			
		

	





	

		

			

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

				
			

			

				

					wu1004019946的博客
				

				

					07-08
					
					1435
					
				

			

		

		

			
				
对ArkTS TypedArray中的每个元素应用指定的回调函数，并使用结果创建一个新的ArkTS TypedArray对象。对ArkTS TypedArray中的每个元素执行归约函数，且接收一个初始值作为归约函数首次调用的参数，并返回最终的归约结果。对ArkTS TypedArray中的每个元素执行归约函数，且接收一个初始值作为归约函数首次调用的参数，并返回最终的归约结果。返回一个新的迭代器对象，该对象包含ArkTS TypedArray中每个元素的键值对。

			
		

	





	

		

			

				
					
鸿蒙 ——ArkTS（数组）

				
			

			

				

					XC1582007430的博客
				

				

					07-03
					
					2057
					
				

			

		

		

			
				
1.在数组头部增加2.在数组尾部增加3.删除数组头部4.删除数组尾部5.任意位置添加/删除元素6.遍历数组（简洁方式）

			
		

	





	

		

			

				
					
【HarmonyOS NEXT应用开发】案例29：ArkTS多线程的多线程系列（一）：ArkTS多线能力入门

				
			

			

				

					xzs51job的专栏
				

				

					08-14
					
					99
					
				

			

		

		

			
				
仅有满足条件的线程才能够被释放。通过taskpool.Task或者taskpool.LongTask构建TaskPool线程池任务，构造方法如let task: taskpool.Task = new taskpool.Task(taskName, taskFun, args);Worker的生命周期需要开发者自行进行管理，也就是说创建出Worker线程后，开发者需要管理Worker线程实例，因此当不需要再使用该线程后，需要显示调用Worker的terminate()方法，将Worker线程实例销毁掉。

			
		

	





	

		

			

				
					
JUC之各种线程安全容器

				
			

			

				

					weixin_42610002的博客
				

				

					03-04
					
					559
					
				

			

		

		

			
				
CopyOnWrite系列、Concurrent系列大体结构Concurrent系列CopyOnWrite系列
大体结构

总体结构比较简单。
Concurrent系列
如果应用侧重于Map放入与获取的速度，而不在意顺序的话ConcurrentHashMap很好，反之ConcurrentSkipListMap 更适合，如果我们对大量数据做频繁的修改，ConcurrentSkipListMap 也可...

			
		

	





	

		

			

				
					
Collections.synchronizedList 、CopyOnWriteArrayList、Vector介绍、源码浅析与性能对比【文末福利】

				
			

			

				

					Nauyus的技术博客
				

				

					02-01
					
					4410
					
				

			

		

		

			
				
本文简要的分析了下Collections.synchronizedList 、CopyOnWriteArrayList、Vector线程安全的实现机制并对它们的读，写，迭代性能进行了对比。

			
		

	





	

		

			

				
					
鸿蒙5.0开发进阶：NDK开发-使用Node-API接口进行array相关开发

					
最新发布

				
			

			

				

					Androidbye的博客
				

				

					10-21
					
					1033
					
				

			

		

		

			
				
使用Node-API接口进行数组（array）相关开发时，涉及的基本概念主要包括数组的创建、访问、修改、遍历以及与数组相关的操作。

			
		

	





	

		

			

				
					
鸿蒙Uint8Array转string

				
			

			

				

					qq906786621的专栏
				

				

					06-11
					
					635
					
				

			

		

		

			
				
鸿蒙Uint8Array to string 方法。

			
		

	





	

		

			

				
					
鸿蒙HarmonyOS开发：ArrayBuffer序列化和转移

				
			

			

				

					keleeQAQ的博客
				

				

					08-13
					
					1453
					
				

			

		

		

			
				
在应用开发中，为了避免主线程阻塞，提高应用性能，需要将一些耗时操作放在子线程中执行。

			
		

	





	

		

			

				
					
HarmonyOS 应用开发之线性容器

				
			

			

				

					maniuT的博客
				

				

					04-01
					
					607
					
				

			

		

		

			
				
线性容器实现能按顺序访问的数据结构，其底层主要通过数组实现，包括ArrayList、Vector、List、LinkedList、Deque、Queue、Stack七种。线性容器，充分考虑了数据访问的速度，运行时（Runtime）通过一条字节码指令就可以完成增、删、改、查等操作。

			
		

	





	

		

			

				
					
JS中操作数组的方法（全）

				
			

			

				

					weixin_55697644的博客
				

				

					05-24
					
					4082
					
				

			

		

		

			
				
元素，并返回该元素的值。此方法会更改数组的长度。

			
		

	





	

		

			

				
					
说一说鸿蒙 数组常用的API有那些？或者说ArkTS中Array 对象常用 的API？

				
			

			

				

					H1453571548的博客
				

				

					09-03
					
					1002
					
				

			

		

		

			
				
数组在编程中非常常用，通常会涉及到以下一些常用的数组API：
length：返回数组的长度，即数组中元素的个数。
push：向数组末尾添加一个或多个元素，并返回新的数组长度。
pop：删除数组的最后一个元素，并返回被删除的元素。
shift：删除数组的第一个元素，并返回被删除的元素。
unshift：向数组的开头添加一个或多个元素，并返回新的数组长度。
concat：将两个或多个数组合并成一个新数组，并返回该新数组。
slice：返回数组的指定部分，创建一个新的数组。


			
		

	



              




          




        



    





    



      

      

        
      

      





	

		评论	
	

	
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  





	
打赏作者

	

		

		
			
		
		

		

			
ConneyWu

			
你的鼓励将是我创作的最大动力

		

	

	

			

	

	

    ¥1
    ¥2
    ¥4
    ¥6
    ¥10
    ¥20
	

	

		

			

				

					扫码支付：¥1
				

				

					

					
					获取中
					

				

				

					
					
					扫码支付
				

			

		

		

			
您的余额不足，请更换扫码支付或充值

			
打赏作者

		

	



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值