diff --git a/zh-cn/application-dev/reference/apis/js-apis-arraylist.md b/zh-cn/application-dev/reference/apis/js-apis-arraylist.md index 2e18337e1251bd9d1ae1264d2c6e04391f62cb31..a0004ab25d3b0ebd422b3aa839065bead05b09d7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-arraylist.md +++ b/zh-cn/application-dev/reference/apis/js-apis-arraylist.md @@ -3,20 +3,26 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。 + +ArrayList和[Vector](js-apis-vector.md)相似，都是基于数组实现。它们都可以动态调整容量，但Vector每次扩容增加1倍。 + +ArrayList和[LinkedList](js-apis-linkedlist.md)相比，ArrayList的随机访问效率更高。但由于ArrayList的增删操作会影响数组内其他元素的移动，LinkedList的增加和删除操作效率更高。 + +**推荐使用场景：** 当需要频繁读取集合中的元素时，推荐使用ArrayList。 + ## 导入模块 ```ts import ArrayList from '@ohos.util.ArrayList'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## ArrayList ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | ArrayList的元素个数。 | @@ -28,6 +34,8 @@ constructor() ArrayList的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -41,6 +49,8 @@ add(element: T): boolean 在ArrayList尾部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -71,6 +81,8 @@ insert(element: T, index: number): void 在长度范围内任意位置插入指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -93,6 +105,8 @@ has(element: T): boolean 判断此ArrayList中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -120,6 +134,8 @@ getIndexOf(element: T): number 返回指定元素第一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -152,6 +168,8 @@ getLastIndexOf(element: T): number 返回指定元素最后一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -184,6 +202,8 @@ removeByIndex(index: number): T 根据元素的下标值查找元素，返回元素后将其删除。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -214,6 +234,8 @@ remove(element: T): boolean 删除查找到的第一个指定的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -243,6 +265,8 @@ removeByRange(fromIndex: number, toIndex: number): void 从一段范围内删除元素，包括起始值但不包括终止值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -270,6 +294,8 @@ thisArg?: Object): void 用户操作ArrayList中的元素，用操作后的元素替换原元素并返回操作后的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -308,6 +334,8 @@ thisArg?: Object): void 通过回调函数来遍历ArrayList实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -342,6 +370,8 @@ sort(comparator?: (firstValue: T, secondValue: T) => number): void 对ArrayList中的元素排序。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -374,6 +404,8 @@ subArrayList(fromIndex: number, toIndex: number): ArrayList<T> 根据下标截取ArrayList中的一段元素，并返回这一段ArrayList实例，包括起始值但不包括终止值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -406,6 +438,8 @@ clear(): void 清除ArrayList中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -423,6 +457,8 @@ clone(): ArrayList<T> 克隆一个与ArrayList相同的实例，并返回克隆后的实例。修改克隆后的实例并不会影响原实例。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** @@ -447,6 +483,8 @@ getCapacity(): number 获取当前实例的容量大小。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -470,6 +508,8 @@ convertToArray(): Array<T> 把当前ArrayList实例转换成数组，并返回转换后的数组。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -493,6 +533,8 @@ isEmpty(): boolean 判断该ArrayList是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -516,6 +558,8 @@ increaseCapacityTo(newCapacity: number): void 如果传入的新容量大于或等于ArrayList中的元素个数，将容量变更为新容量。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -540,6 +584,8 @@ trimToCurrentLength(): void 把容量限制为当前的length大小。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -557,6 +603,8 @@ arrayList.trimToCurrentLength(); 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象，并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-deque.md b/zh-cn/application-dev/reference/apis/js-apis-deque.md index 1ad1b76474eb679fa8ef45530d6c5c033e3bb9c0..2d9c75c123d52b61e90188541760f27d7234cfcf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-deque.md +++ b/zh-cn/application-dev/reference/apis/js-apis-deque.md @@ -3,6 +3,13 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +Deque（double ended queue）根据循环队列的数据结构实现，符合先进先出以及先进后出的特点，支持两端的元素插入和移除。Deque会根据实际需要动态调整容量，每次进行两倍扩容。 + +Deque和[Queue](js-apis-queue.md)相比，Queue的特点是先进先出，只能在头部删除元素，尾部增加元素。 + +与[Vector](js-apis-vector.md)相比，它们都支持在两端增删元素，但Deque不能进行中间插入的操作。对头部元素的插入删除效率高于Vector，而Vector访问元素的效率高于Deque。 + +**推荐使用场景：** 需要频繁在集合两端进行增删元素的操作时，推荐使用Deque。 ## 导入模块 @@ -10,14 +17,12 @@ import Deque from '@ohos.util.Deque'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## Deque ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | Deque的元素个数。 | @@ -28,6 +33,8 @@ constructor() Deque的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -40,6 +47,8 @@ insertFront(element: T): void 在deque头部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -64,6 +73,8 @@ insertEnd(element: T): void 在deque尾部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -88,6 +99,8 @@ has(element: T): boolean 判断此Deque中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -115,6 +128,8 @@ popFirst(): T 删除并返回双端队列的首元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -139,6 +154,8 @@ popLast(): T 删除并返回双端队列的尾元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -164,6 +181,8 @@ thisArg?: Object): void 通过回调函数来遍历Deque实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -198,6 +217,8 @@ getFirst(): T 获取Deque实例中的头元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -221,6 +242,8 @@ getLast(): T 获取Deque实例中的尾元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -242,9 +265,10 @@ let result = deque.getLast(); [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md index cfb107c2fc7fbb901fa0525e85925aec4eb92fbf..746176465576b85cd8c6e7b746bee81c767973db 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md @@ -3,6 +3,13 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +HashMap底层使用数组+链表+红黑树的方式实现，查询、插入和删除的效率都很高。HashMap存储内容基于key-value的键值对映射，不能有重复的key，且一个key只能对应一个value。 + +HashMap和[TreeMap](js-apis-treemap.md)相比，HashMap依据键的hashCode存取数据，访问速度较快。而TreeMap是有序存取，效率较低。 + +[HashSet](js-apis-hashset.md)基于HashMap实现。HashMap的输入参数由key、value两个值组成。在HashSet中，只对value对象进行处理。 + +**推荐使用场景：** 需要快速存取、删除以及插入键值对数据时，推荐使用HashMap。 ## 导入模块 @@ -10,15 +17,12 @@ import HashMap from '@ohos.util.HashMap'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## HashMap - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | HashMap的元素个数。 | @@ -30,6 +34,8 @@ constructor() HashMap的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -43,6 +49,8 @@ isEmpty(): boolean 判断该HashMap是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -63,6 +71,8 @@ hasKey(key: K): boolean 判断此HashMap中是否含有该指定key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -91,6 +101,8 @@ hasValue(value: V): boolean 判断此HashMap中是否含有该指定value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -119,6 +131,8 @@ get(key: K): V 获取指定key所对应的value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -147,6 +161,8 @@ setAll(map: HashMap): void 将一个HashMap中的所有元素组添加到另一个hashMap中。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -170,6 +186,8 @@ set(key: K, value: V): Object 向HashMap中添加一组数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -197,6 +215,8 @@ remove(key: K): V 删除指定key所对应元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -225,6 +245,8 @@ clear(): void 清除HashMap中的所有元素,并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -241,6 +263,8 @@ keys(): IterableIterator<K> 返回包含此映射中包含的键名的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -268,6 +292,8 @@ values(): IterableIterator<V> 返回包含此映射中包含的键值的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -295,6 +321,8 @@ replace(key: K, newValue: V): boolean 对HashMap中一组数据进行更新（替换）。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -323,6 +351,8 @@ forEach(callbackfn: (value?: V, key?: K, map?: HashMap) => void, thisArg?: 通过回调函数来遍历HashMap实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -355,6 +385,8 @@ entries(): IterableIterator<[K, V]> 返回包含此映射中包含的键值对的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -383,6 +415,8 @@ while(temp != undefined) { 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-hashset.md b/zh-cn/application-dev/reference/apis/js-apis-hashset.md index 29d056156d11aad27b903572fa21d832251a2c42..fd7cf5eeb8db8842aa0ab7378a562593f768a790 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hashset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hashset.md @@ -3,6 +3,11 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +HashSet基于[HashMap](js-apis-hashmap.md)实现。在HashSet中，只对value对象进行处理。 + +HashSet和[TreeSet](js-apis-treeset.md)相比，HashSet中的数据无序存放，即存放元素的顺序和取出的顺序不一致，而TreeSet是有序存放。它们集合中的元素都不允许重复，但HashSet允许放入null值，TreeSet不允许。 + +**推荐使用场景：** 可以利用HashSet不重复的特性，当需要不重复的集合或需要去重某个集合的时候使用。 ## 导入模块 @@ -10,15 +15,12 @@ import HashSet from '@ohos.util.HashSet'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## HashSet - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | HashSet的元素个数。 | @@ -30,6 +32,8 @@ constructor() HashSet的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -43,6 +47,8 @@ isEmpty(): boolean 判断该HashSet是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -63,6 +69,8 @@ has(value: T): boolean 判断此HashSet中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -91,6 +99,8 @@ add(value: T): boolean 向HashSet中添加数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -117,6 +127,8 @@ remove(value: T): boolean 删除指定的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -145,6 +157,8 @@ clear(): void 清除HashSet中的所有元素,并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -161,6 +175,8 @@ values(): IterableIterator<T> 返回包含此映射中包含的键值的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -188,6 +204,8 @@ forEach(callbackfn: (value?: T, key?: T, set?: HashSet<T>) => void, thisAr 通过回调函数来遍历实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -219,6 +237,8 @@ entries(): IterableIterator<[T, T]> 返回包含此映射中包含的键值对的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -245,7 +265,9 @@ while(temp != undefined) { [Symbol.iterator]\(): IterableIterator<T> -返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象，并返回该对象。 + +**系统能力：** SystemCapability.Utils.Lang **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md b/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md index aa960436b5d1ba9e9843910123725a5f6184187e..444b5e783b66ae99b2bdee8ef12b9bab03bb3133 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md @@ -3,6 +3,13 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +LightWeightMap可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，每个key对应一个value。 + +LightWeightMap依据泛型定义，采用轻量级结构，集合中key值的查找依赖于hash算法，通过一个数组存储hash值，然后映射到其他数组中的key值及value值。 + +LightWeightMap和[HashMap](js-apis-hashmap.md)都是用来存储键值对的集合，LightWeightMap占用内存更小。 + +**推荐使用场景：** 当需要存取key-value键值对时，推荐使用占用内存更小的LightWeightMap。 ## 导入模块 @@ -10,15 +17,14 @@ import LightWeightMap from '@ohos.util.LightWeightMap'; ``` -## 系统能力 -SystemCapability.Utils.Lang ## LightWeightMap - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | LightWeightMap的元素个数。 | @@ -30,6 +36,8 @@ constructor() LightWeightMap的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -43,6 +51,8 @@ isEmpty(): boolean 判断该LightWeightMap是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -63,6 +73,8 @@ hasAll(map: LightWeightMap): boolean 判断此LightWeightMap中是否含有该指定map中的所有元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -93,6 +105,8 @@ hasKey(key: K): boolean; 判断此LightWeightMap中是否含有该指定key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -122,6 +136,8 @@ hasValue(value: V): boolean 判断此LightWeightMap中是否含有该指定value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -150,6 +166,8 @@ increaseCapacityTo(minimumCapacity: number): void 将当前LightWeightMap扩容至可以容纳指定数量元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -170,6 +188,8 @@ get(key: K): V 获取指定key所对应的value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -198,6 +218,8 @@ getIndexOfKey(key: K): number 查找指定元素第一次出现的下标值，如果没有找到该元素返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -226,6 +248,8 @@ getIndexOfValue(value: V): number 查找指定元素第一次出现的下标值，如果没有找到该元素返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -254,6 +278,8 @@ getKeyAt(index: number): K 查找指定下标的元素键值对中key值，否则返回undefined。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -282,6 +308,8 @@ setAll(map: LightWeightMap): void 将一个LightWeightMap中的所有元素组添加到另一个lightWeightMap中。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -304,6 +332,8 @@ set(key: K, value: V): Object 向LightWeightMap中添加一组数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -331,6 +361,8 @@ remove(key: K): V 删除并返回指定key映射的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -359,6 +391,8 @@ removeAt(index: number): boolean 删除指定下标对应的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -387,6 +421,8 @@ setValueAt(index: number, newValue: V): boolean 替换指定下标对应键值对中的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -416,6 +452,8 @@ getValueAt(index: number): V 获取指定下标对应键值对中的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -444,6 +482,8 @@ clear(): void 清除LightWeightMap中的所有元素,并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -460,6 +500,8 @@ keys(): IterableIterator<K> 返回包含此映射中包含的键的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -487,6 +529,8 @@ values(): IterableIterator<V> 返回包含此映射中包含的键值的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -514,6 +558,8 @@ forEach(callbackfn: (value?: V, key?: K, map?: LightWeightMap) => void, th 通过回调函数来遍历实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -546,6 +592,8 @@ entries(): IterableIterator<[K, V]> 返回包含此映射中包含的键值对的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -573,6 +621,8 @@ toString(): String 将此映射中包含的键值对拼接成字符串，并返回字符串类型。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -594,6 +644,8 @@ toString(): String 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md b/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md index 99d37c6bcb6a007e50fd1afccb575a3cf26894bf..a308d35203c30c1a5d69d27f2a8eb9d3ae5a99a7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md @@ -3,6 +3,15 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +LightWeightSet可用于存储一系列值的集合，存储元素中value值唯一。 + +LightWeightSet依据泛型定义，采用轻量级结构，初始默认容量大小为8，每次扩容大小为原始容量的两倍。 + +集合中value值的查找依赖于hash算法，通过一个数组存储hash值，然后映射到其他数组中的value值。 + +LightWeightSet和[HashSet](js-apis-hashset.md)都是用来存储键值的集合，LightWeightSet的占用内存更小。 + +**推荐使用场景：** 当需要存取某个集合或是对某个集合去重时，推荐使用占用内存更小的LightWeightSet。 ## 导入模块 @@ -10,15 +19,14 @@ import LightWeightSet from '@ohos.util.LightWeightSet'; ``` -## 系统能力 -SystemCapability.Utils.Lang ## LightWeightSet - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | LightWeightSet的元素个数。 | @@ -30,6 +38,8 @@ constructor() LightWeightSet的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -43,6 +53,8 @@ isEmpty(): boolean 判断该容器是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -62,6 +74,8 @@ add(obj: T): boolean 向此容器中添加数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -88,6 +102,8 @@ addAll(set: LightWeightSet<T>): boolean 将另一个容器中的所有元素组添加到当前容器中。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -112,6 +128,8 @@ hasAll(set: LightWeightSet<T>): boolean 判断此容器中是否含有该指定set中的所有元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -142,6 +160,8 @@ has(key: T): boolean 判断此容器中是否含有该指定key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -170,6 +190,8 @@ equal(obj: Object): boolean 判断此容器中是否含有该指定obj同类型的对象。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -199,6 +221,8 @@ increaseCapacityTo(minimumCapacity: number): void 将当前容器扩容至可以容纳指定数量元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -219,6 +243,8 @@ getIndexOf(key: T): number 获取指定key所对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -247,6 +273,8 @@ remove(key: T): T 删除并返回指定key对应的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -275,6 +303,8 @@ removeAt(index: number): boolean 删除指定下标所对应的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -303,6 +333,8 @@ getValueAt(index: number): T 获取此容器中指定下标对应的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -331,6 +363,8 @@ clear(): void 清除容器中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -347,6 +381,8 @@ toString(): String 获取包含容器中所有键和值的字符串。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -369,6 +405,8 @@ toArray(): Array<T> 获取包含此容器中所有对象的数组。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -391,6 +429,8 @@ values(): IterableIterator<T> 返回包含此映射中包含的键值的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -418,6 +458,8 @@ forEach(callbackfn: (value?: T, key?: T, set?: LightWeightSet<T>) => void, 通过回调函数来遍历LightWeightSet实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -450,6 +492,8 @@ entries(): IterableIterator<[T, T]> 返回包含此映射中包含的键值对的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -477,6 +521,8 @@ while(index < lightWeightSet.length) { 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md b/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md index b6be34281adf99b9c29740765f6a05863a772565..e5a46eae66cff08fd3999798718e74a954d28b46 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md +++ b/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md @@ -3,6 +3,13 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +LinkedList底层通过双向链表实现，双向链表的每个节点都包含对前一个元素和后一个元素的引用。当需要查询元素时，可以从头遍历，也可以从尾部遍历，插入、删除效率高，查询效率低。LinkedList允许元素为null。 + +LinkedList和[List](js-apis-list.md)相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。 + +LinkedList和[ArrayList](js-apis-arraylist.md)相比，存取数据的效率不如ArrayList。 + +**推荐使用场景：** 当需要频繁的插入删除时，推荐使用LinkedList高效操作。 ## 导入模块 @@ -10,16 +17,15 @@ import LinkedList from '@ohos.util.LinkedList'; ``` -## 系统能力 -SystemCapability.Utils.Lang ## LinkedList - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | LinkedList的元素个数。 | @@ -31,6 +37,8 @@ constructor() LinkedList的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** @@ -45,6 +53,8 @@ add(element: T): boolean 在LinkedList尾部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -75,6 +85,8 @@ addFirst(element: T): void 在LinkedList头部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -99,6 +111,8 @@ insert(index: number, element: T): void 在长度范围内任意插入指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -121,6 +135,8 @@ has(element: T): boolean 判断此LinkedList中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -148,6 +164,8 @@ get(index: number): T 根据下标获取LinkedList中的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -180,6 +198,8 @@ getLastIndexOf(element: T): number 返回指定元素最后一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -212,6 +232,8 @@ getIndexOf(element: T): number 返回指定元素第一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -244,6 +266,8 @@ removeByIndex(index: number): T 根据元素的下标值查找元素，返回元素后将其删除。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -274,6 +298,8 @@ removeFirst(): T 删除并返回LinkedList的第一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -298,6 +324,8 @@ removeLast(): T 删除并返回LinkedList的最后一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -322,6 +350,8 @@ remove(element: T): boolean 删除查找到的第一个指定的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -351,6 +381,8 @@ removeFirstFound(element: T): boolean 删除第一次出现的指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -380,6 +412,8 @@ removeLastFound(element: T): boolean 删除最后一次出现的指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -409,6 +443,8 @@ clone(): LinkedList<T> 克隆一个与LinkedList相同的实例，并返回克隆后的实例。修改克隆后的实例并不会影响原实例。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -433,6 +469,8 @@ thisArg?: Object): void 通过回调函数来遍历LinkedList实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -467,6 +505,8 @@ clear(): void 清除LinkedList中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -484,6 +524,8 @@ set(index: number, element: T): T 将此LinkedList中指定位置的元素替换为指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -514,6 +556,8 @@ convertToArray(): Array<T> 把当前LinkedList实例转换成数组，并返回转换后的数组。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -536,6 +580,8 @@ getFirst(): T 获取LinkedList实例中的第一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -559,6 +605,8 @@ getLast(): T 获取LinkedList实例中的最后一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -580,9 +628,10 @@ linkedList.getLast(); [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象，并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-list.md b/zh-cn/application-dev/reference/apis/js-apis-list.md index 72ded213885467aee03a261e71a7f3f6682200d0..bbb62d162dfa7a62eed3845750fba59a6921003c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-list.md +++ b/zh-cn/application-dev/reference/apis/js-apis-list.md @@ -3,6 +3,11 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +List底层通过单向链表实现，每个节点有一个指向后一个元素的引用。当需要查询元素时，必须从头遍历，插入、删除效率高，查询效率低。List允许元素为null。 + +List和[LinkedList](js-apis-linkedlist.md)相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。 + +**推荐使用场景：** 当需要频繁的插入删除时，推荐使用List高效操作。 ## 导入模块 @@ -10,16 +15,13 @@ import List from '@ohos.util.List'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## List - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | List的元素个数。 | @@ -31,6 +33,8 @@ constructor() List的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** @@ -45,6 +49,8 @@ add(element: T): boolean 在List尾部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -75,6 +81,8 @@ insert(element: T, index: number): void 在长度范围内任意位置插入指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -97,6 +105,8 @@ has(element: T): boolean 判断此List中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -124,6 +134,8 @@ get(index: number): T 根据下标获取List中的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -156,6 +168,8 @@ getLastIndexOf(element: T): number 查找指定元素最后一次出现的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -188,6 +202,8 @@ getIndexOf(element: T): number 查找指定元素第一次出现的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -221,6 +237,8 @@ equal(obj: Object): boolean 比较指定对象与此List是否相等。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -256,6 +274,8 @@ removeByIndex(index: number): T 根据元素的下标值查找元素，返回元素后将其删除。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -286,6 +306,8 @@ remove(element: T): boolean 删除查找到的第一个指定的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -316,6 +338,8 @@ thisArg?: Object): void 用户操作List中的元素,用操作后的元素替换原元素并返回操作后的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -354,6 +378,8 @@ thisArg?: Object): void 通过回调函数来遍历List实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -389,6 +415,8 @@ sort(comparator: (firstValue: T, secondValue: T) => number): void 对List中的元素进行一个排序操作。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -420,6 +448,8 @@ getSubList(fromIndex: number, toIndex: number): List<T> 根据下标截取List中的一段元素，并返回这一段List实例，包括起始值但不包括终止值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -452,6 +482,8 @@ clear(): void 清除List中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -469,6 +501,8 @@ set(index: number, element: T): T 将此 List 中指定位置的元素替换为指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -500,6 +534,8 @@ convertToArray(): Array<T> 把当前List实例转换成数组，并返回转换后的数组。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -523,6 +559,8 @@ isEmpty(): boolean 判断该List是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -546,6 +584,8 @@ getFirst(): T 获取List实例中的第一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -569,6 +609,8 @@ getLast(): T 获取List实例中的最后一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -590,9 +632,10 @@ let result = list.getLast(); [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象，并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-plainarray.md b/zh-cn/application-dev/reference/apis/js-apis-plainarray.md index 353c68b0bd4d3b2a8a936af39aa88c5b421559c4..2a96f5917a46f4c7d3bc2d868ca1b70b8893ff1f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-plainarray.md +++ b/zh-cn/application-dev/reference/apis/js-apis-plainarray.md @@ -3,6 +3,13 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +PlainArray可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，key值类型为number类型，每个key对应一个value。 + +PlainArray依据泛型定义，采用轻量级结构，集合中key值的查找依赖于二分查找算法，然后映射到其他数组中的value值。 + +PlainArray和[LightWeightMap](js-apis-lightweightmap.md)都是用来存储键值对，且均采用轻量级结构，但PlainArray的key值类型只能为number类型。 + +**推荐使用场景：** 当需要存储key值为number类型的键值对时，可以使用PlainArray。 ## 导入模块 @@ -10,15 +17,14 @@ import PlainArray from '@ohos.util.PlainArray'; ``` -## 系统能力 -SystemCapability.Utils.Lang ## PlainArray - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | PlainArray的元素个数。 | @@ -30,6 +36,8 @@ constructor() PlainArray的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -43,6 +51,8 @@ isEmpty(): boolean 判断该容器是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -63,6 +73,8 @@ has(key: number): boolean 判断此容器中是否含有该指定key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -91,6 +103,8 @@ get(key: number): T 获取指定key所对应的value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -119,6 +133,8 @@ getIndexOfKey(key: number): number 查找指定key第一次出现的下标值，如果没有找到该key返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -147,6 +163,8 @@ getIndexOfValue(value: T): number 查找指定value元素第一次出现的下标值，如果没有找到该value元素返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -175,6 +193,8 @@ getKeyAt(index: number): number 查找指定下标的元素键值对中key值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -202,6 +222,8 @@ getValueAt(index: number): T 查找指定下标元素键值对中Value值，否则返回undefined。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -229,6 +251,8 @@ clone(): PlainArray<T> 克隆一个实例，并返回克隆后的实例。修改克隆后的实例并不会影响原实例。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -251,6 +275,8 @@ add(key: number, value: T): void 向容器中添加一组数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -272,6 +298,8 @@ remove(key: number): T 删除指定key对应元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -301,6 +329,8 @@ removeAt(index: number): T 删除指定下标对应的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -330,6 +360,8 @@ removeRangeFrom(index: number, size: number): number 删除一定范围内的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -359,6 +391,8 @@ setValueAt(index: number, value: T): void 替换容器中指定下标对应键值对中的键值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -382,6 +416,8 @@ toString(): String 获取包含容器中所有键和值的字符串。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -404,6 +440,8 @@ clear(): void 清除容器中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -420,6 +458,8 @@ forEach(callbackfn: (value: T, index?: number, PlainArray?: PlainArray<T>) 通过回调函数来遍历实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -452,6 +492,8 @@ plainArray.forEach((value, index) => { 返回一个迭代器，迭代器的每一项都是一个 JavaScript对象，并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-queue.md b/zh-cn/application-dev/reference/apis/js-apis-queue.md index 86edd7a79ebf1ef3b8c6570d90c79182aea072df..b8d81d54e124889764a17782cc08ef27723f6ebf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-queue.md +++ b/zh-cn/application-dev/reference/apis/js-apis-queue.md @@ -3,6 +3,11 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +Queue的特点是先进先出，在尾部增加元素，在头部删除元素。根据循环队列的数据结构实现。 + +Queue和[Deque](js-apis-deque.md)相比，Queue只能在一端删除一端增加，Deque可以两端增删。 + +**推荐使用场景：** 一般符合先进先出的场景可以使用Queue。 ## 导入模块 @@ -10,16 +15,13 @@ import Queue from '@ohos.util.Queue'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## Queue - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | Queue的元素个数。 | @@ -31,6 +33,8 @@ constructor() Queue的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -44,6 +48,8 @@ add(element: T): boolean 在队列尾部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -75,6 +81,8 @@ pop(): T 删除头元素并返回该删除元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -99,6 +107,8 @@ getFirst(): T 获取队列的头元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 类型 | 说明 | @@ -123,6 +133,8 @@ thisArg?: Object): void 通过回调函数来遍历Queue实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -156,9 +168,10 @@ queue.forEach((value, index) => { [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-stack.md b/zh-cn/application-dev/reference/apis/js-apis-stack.md index de2efb76dd8a16884c675e46403f3a81aa6677ff..3f8acdad6738a2d96306d1c2583a4fabe275cc4f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-stack.md +++ b/zh-cn/application-dev/reference/apis/js-apis-stack.md @@ -3,6 +3,11 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +Stack基于数组的数据结构实现，特点是先进后出，只能在一端进行数据的插入和删除。 + +Stack和[Queue](js-apis-queue.md)相比，Queue基于循环队列实现，只能在一端删除，另一端插入，而Stack都在一端操作。 + +**推荐使用场景：** 一般符合先进后出的场景可以使用Stack。 ## 导入模块 @@ -10,16 +15,15 @@ import Stack from '@ohos.util.Stack'; ``` -## 系统能力 -SystemCapability.Utils.Lang ## Stack - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | Stack的元素个数。 | @@ -31,6 +35,8 @@ constructor() Stack的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -44,6 +50,8 @@ push(item: T): T 在栈顶插入元素，并返回该元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -74,6 +82,8 @@ pop(): T 删除栈顶元素并返回该删除元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -98,6 +108,8 @@ peek(): T 获取并返回栈顶元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -121,6 +133,8 @@ locate(element: T): number 返回指定元素第一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -151,6 +165,8 @@ thisArg?: Object): void 通过回调函数来遍历Stack实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -185,6 +201,8 @@ isEmpty(): boolean 判断该栈是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -206,9 +224,10 @@ let result = stack.isEmpty(); [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-treemap.md b/zh-cn/application-dev/reference/apis/js-apis-treemap.md index 4ca6d30d62dfc9b5c151c30f55a640629b6b726c..e9507818321ae4ee853faaf870d9644b32f99cb7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-treemap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-treemap.md @@ -3,6 +3,13 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +TreeMap可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，每个key对应一个value。 + +TreeMap底层使用红黑树实现，可以利用二叉树特性快速查找键值对。key值有序存储，可以实现快速的插入和删除。 + +TreeMap和[HashMap](js-apis-treemap.md)相比，HashMap依据键的hashCode存取数据，访问速度较快。而TreeMap是有序存取，效率较低。 + +**推荐使用场景：** 一般需要存储有序键值对的场景，可以使用TreeMap。 ## 导入模块 @@ -10,15 +17,12 @@ import TreeMap from '@ohos.util.TreeMap'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## TreeMap - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | TreeMap的元素个数。 | @@ -30,6 +34,8 @@ constructor(comparator?:(firstValue: K, secondValue: K) => boolean) TreeMap的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -49,6 +55,8 @@ isEmpty(): boolean 判断该容器是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -69,6 +77,8 @@ hasKey(key: K): boolean 判断此容器中是否含有该指定key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -97,6 +107,8 @@ hasValue(value: V): boolean 判断此容器中是否含有该指定value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -125,6 +137,8 @@ get(key: K): V 获取指定key所对应的value。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -153,6 +167,8 @@ getFirstKey(): K 获取容器中排序第一的key。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -175,6 +191,8 @@ getLastKey(): K 获取容器中排序最后的key。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -197,6 +215,8 @@ setAll(map: TreeMap): void 将一个TreeMap中的所有元素组添加到另一个TreeMap中。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -220,6 +240,8 @@ set(key: K, value: V): Object 向容器中添加一组数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -247,6 +269,8 @@ remove(key: K): V 删除指定key对应的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -275,6 +299,8 @@ getLowerKey(key: K): K 获取容器中比传入key排序靠前一位的key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -304,6 +330,8 @@ getHigherKey(key: K): K 获取容器中比传入key排序靠后一位的key。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -332,6 +360,8 @@ replace(key: K, newValue: V): boolean 对容器中一组数据进行更新（替换）。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -360,6 +390,8 @@ clear(): void 清除容器中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -376,6 +408,8 @@ keys(): IterableIterator<K> 返回包含此映射中包含的键的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -403,6 +437,8 @@ values(): IterableIterator<V> 返回包含此映射中包含的键值的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -430,6 +466,8 @@ forEach(callbackfn: (value?: V, key?: K, map?: TreeMap) => void, thisArg?: 通过回调函数来遍历实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -462,6 +500,8 @@ entries(): IterableIterator<[K, V]> 返回包含此映射中包含的键值对的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -488,9 +528,10 @@ while(temp != undefined) { [Symbol.iterator]\(): IterableIterator<[K, V]> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象，并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | | -------- | -------- | diff --git a/zh-cn/application-dev/reference/apis/js-apis-treeset.md b/zh-cn/application-dev/reference/apis/js-apis-treeset.md index 9c0fc5270534ac2be8b7e35e3b62ff4df4864237..0a6b7e9958902bc448b065f099cd6f86f8275cef 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-treeset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-treeset.md @@ -3,6 +3,11 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +TreeSet基于[TreeMap](js-apis-treemap.md)实现，在TreeSet中，只对value对象进行处理。TreeSet可用于存储一系列值的集合，元素中value唯一且有序。 + +TreeSet和[HashSet](js-apis-hashset.md)相比，HashSet中的数据无序存放，而TreeSet是有序存放。它们集合中的元素都不允许重复，但HashSet允许放入null值，TreeSet不允许。 + +**推荐使用场景：** 一般需要存储有序集合的场景，可以使用TreeSet。 ## 导入模块 @@ -10,15 +15,12 @@ import TreeSet from '@ohos.util.TreeSet'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## TreeSet - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | TreeSet的元素个数。 | @@ -30,6 +32,8 @@ constructor(comparator?:(firstValue: T, secondValue: T) => boolean) TreeSet的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -49,6 +53,8 @@ isEmpty(): boolean 判断该容器是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -69,6 +75,8 @@ has(value: T): boolean 判断此容器中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -97,6 +105,8 @@ getFirstValue(): T 获取容器中排序第一的数据。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -119,6 +129,8 @@ getLastValue(): T 获取容器中排序最后的数据。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -141,6 +153,8 @@ add(value: T): boolean 向容器中添加一组数据。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -167,6 +181,8 @@ remove(value: T): boolean 删除指定的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -195,6 +211,8 @@ getLowerValue(key: T): T 获取容器中比传入元素排序靠前一位的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -224,6 +242,8 @@ getHigherValue(key: T): T 获取容器中比传入元素排序靠后一位的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -253,6 +273,8 @@ popFirst(): T 删除容器中排序最前的数据。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -275,6 +297,8 @@ popLast(): T 删除容器中排序最后的数据。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -297,6 +321,8 @@ clear(): void 清除容器中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -313,6 +339,8 @@ values(): IterableIterator<T> 返回包含此映射中包含的键值的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -340,6 +368,8 @@ forEach(callbackfn: (value?: T, key?: T, set?: TreeSet<T>) => void, thisAr 通过回调函数来遍历实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -372,6 +402,8 @@ entries(): IterableIterator<[T, T]> 返回包含此映射中包含的键值对的新迭代器对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -398,9 +430,10 @@ while(temp != undefined) { [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-vector.md b/zh-cn/application-dev/reference/apis/js-apis-vector.md index 193b8576b663228587d935c4cb4171f53d9a051e..d45bb5612d4093160da3d7c148d9e007353cf86b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-vector.md +++ b/zh-cn/application-dev/reference/apis/js-apis-vector.md @@ -3,6 +3,11 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +Vector是一种线性数据结构，底层基于数组实现。当Vector的内存用尽时，会自动分配更大的连续内存区，将原先的元素复制到新的内存区，并释放旧的内存区。使用Vector能够高效快速地访问元素。 + +Vector和[ArrayList](js-apis-arraylist.md)相似，都是基于数组实现，但Vector提供了更多操作数组的接口。它们都可以动态调整容量，但Vector每次扩容增加1倍，ArrayList只扩容0.5倍。 + +**推荐使用场景：** 当数据量大时，一般使用Vector来存取数据。 ## 导入模块 @@ -10,16 +15,13 @@ import Vector from '@ohos.util.Vector'; ``` -## 系统能力 - -SystemCapability.Utils.Lang - ## Vector - ### 属性 +**系统能力：** SystemCapability.Utils.Lang + | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | length | number | 是 | 否 | Vector的元素个数。 | @@ -31,6 +33,8 @@ constructor() Vector的构造函数。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -44,6 +48,8 @@ add(element: T): boolean 在Vector中尾部插入元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -74,6 +80,8 @@ insert(element: T, index: number): void 在长度范围内任意插入指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -96,6 +104,8 @@ has(element: T): boolean 判断此Vector中是否含有该指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -115,7 +125,7 @@ let vector = new Vector(); let result = vector.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf"); vector.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf"); let result1 = vector.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf"); -``` +``` ### getIndexOf @@ -123,6 +133,8 @@ getIndexOf(element: T): number 返回指定元素第一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -155,6 +167,8 @@ getLastIndexOf(element: T): number 返回指定元素最后一次出现时的下标值，查找失败返回-1。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -187,6 +201,8 @@ removeByIndex(index: number): T 根据元素的下标值查找元素，返回元素后将其删除。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -217,6 +233,8 @@ remove(element: T): boolean 删除查找到的第一个指定的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -246,6 +264,8 @@ removeByRange(fromIndex: number, toIndex: number): void 从一段范围内删除元素，包括起始值但不包括终止值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -273,6 +293,8 @@ thisArg?: Object): void 用户操作Vector中的元素，用操作后的元素替换原元素并返回操作后的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -311,6 +333,8 @@ thisArg?: Object): void 通过回调函数来遍历Vector实例对象上的元素以及元素对应的下标。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -346,6 +370,8 @@ sort(comparator?: (firstValue: T, secondValue: T) => number): void 对Vector中的元素进行一个排序操作。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -378,6 +404,8 @@ subVector(fromIndex: number, toIndex: number): Vector<T> 根据下标截取Vector中的一段元素，并返回这一段vector实例，包括起始值但不包括终止值。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -411,6 +439,8 @@ clear(): void 清除Vector中的所有元素，并把length置为0。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** ```ts @@ -428,6 +458,8 @@ clone(): Vector<T> 克隆一个与Vector相同的实例，并返回克隆后的实例。修改克隆后的实例并不会影响原实例。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -451,6 +483,8 @@ getCapacity(): number 获取当前实例的容量大小。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -474,6 +508,8 @@ convertToArray(): Array<T> 把当前Vector实例转换成数组，并返回转换后的数组。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -497,6 +533,8 @@ isEmpty(): boolean 判断该Vector是否为空。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -520,6 +558,8 @@ increaseCapacityTo(newCapacity: number): void 如果传入的新容量大于或等于Vector中的元素个数，将容量变更为新容量。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -544,6 +584,8 @@ trimToCurrentLength(): void 把容量限制为当前的length大小。 +**系统能力：** SystemCapability.Utils.Lang + **示例：** ```ts @@ -561,6 +603,8 @@ toString(): string 用","将Vector实例中的元素按顺序拼接成字符串。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -584,6 +628,8 @@ copyToArray(array: Array<T>): void 将Vector实例中的元素按照下标复制到指定数组。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -608,6 +654,8 @@ getFirstElement(): T 获取实例中的第一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -631,6 +679,8 @@ getLastElement(): T 获取Vector实例中的最后一个元素。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | @@ -654,6 +704,8 @@ getLastIndexFrom(element: T, index: number): number 从指定索引向后搜索，返回该元素的下标索引。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -685,6 +737,8 @@ getIndexFrom(element: T, index: number): number 从指定索引向前搜索，返回该元素的下标索引。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -716,6 +770,8 @@ setLength(newSize: number): void 设置Vector实例的元素个数。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -740,6 +796,8 @@ get(index: number): T 根据下标值获取Vector实例中的元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -768,6 +826,8 @@ set(index: number, element: T): T 将此Vector中指定位置的元素替换为指定元素。 +**系统能力：** SystemCapability.Utils.Lang + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -796,9 +856,10 @@ set(index: number, element: T): T [Symbol.iterator]\(): IterableIterator<T> - 返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象,并返回该对象。 +**系统能力：** SystemCapability.Utils.Lang + **返回值：** | 类型 | 说明 | | -------- | -------- |