1# 非线性容器 2 3 4非线性容器实现能快速查找的数据结构，其底层通过hash或者红黑树实现，包括HashMap、HashSet、TreeMap、TreeSet、LightWeightMap、LightWeightSet、PlainArray七种。非线性容器中的key及value的类型均满足ECMA标准。 5 6 7## HashMap 8 9[HashMap](../reference/apis-arkts/js-apis-hashmap.md)可用来存储具有关联关系的key-value键值对集合，存储元素中key是唯一的，每个key会对应一个value值。 10 11HashMap依据泛型定义，集合中通过key的hash值确定其存储位置，从而快速找到键值对。HashMap的初始容量大小为16，并支持动态扩容，每次扩容大小为原始容量的2倍。HashMap底层基于HashTable实现，冲突策略采用链地址法。 12 13HashMap和[TreeMap](../reference/apis-arkts/js-apis-treemap.md)相比，HashMap依据键的hashCode存取数据，访问速度较快。而TreeMap是有序存取，效率较低。 14 15[HashSet](../reference/apis-arkts/js-apis-hashset.md)基于HashMap实现。HashMap的输入参数由key、value两个值组成。在HashSet中，只对value对象进行处理。 16 17需要快速存取、删除以及插入键值对数据时，推荐使用HashMap。 18 19HashMap进行增、删、改、查操作的常用API如下： 20 21| 操作 | 描述 | 22| -------- | ------ | 23| 增加元素 | 通过set(key: K, value: V)函数每次在HashMap增加一个键值对。 | 24| 访问元素 | 通过get(key: K)获取key对应的value值。 | 25| 访问元素 | 通过keys()返回一个迭代器对象，包含map中的所有key值。 | 26| 访问元素 | 通过values()返回一个迭代器对象，包含map中的所有value值。 | 27| 访问元素 | 通过entries()返回一个迭代器对象，包含map中的所有键值对。 | 28| 访问元素 | forEach(callbackFn: (value?: V, key?: K, map?: HashMap<K, V>) => void, thisArg?: Object)访问整个map的元素。 | 29| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<[K,V]>迭代器进行数据访问。 | 30| 修改元素 | 通过replace(key: K, newValue: V)对指定key对应的value值进行修改操作。 | 31| 修改元素 | 通过forEach(callbackFn: (value?: V, key?: K, map?: HashMap<K, V>) => void, thisArg?: Object)对map中元素进行修改操作。 | 32| 删除元素 | 通过remove(key: K)对map中匹配到的键值对进行删除操作。 | 33| 删除元素 | 通过clear()清空整个map集合。 | 34 35 36## HashSet 37 38[HashSet](../reference/apis-arkts/js-apis-hashset.md)可用来存储一系列值的集合，存储元素中value是唯一的。 39 40HashSet依据泛型定义，集合中通过value的hash值确定其存储位置，从而快速找到该值。HashSet初始容量大小为16，支持动态扩容，每次扩容大小为原始容量的2倍。value的类型满足ECMA标准中要求的类型。HashSet底层数据结构基于HashTable实现，冲突策略采用链地址法。 41 42HashSet基于[HashMap](../reference/apis-arkts/js-apis-hashmap.md)实现。在HashSet中，只对value对象进行处理。 43 44HashSet和[TreeSet](../reference/apis-arkts/js-apis-treeset.md)相比，HashSet中的数据无序存放，即存放元素的顺序和取出的顺序不一致，而TreeSet是有序存放。它们集合中的元素都不允许重复，但HashSet允许放入null值，TreeSet不建议存放null值，可能会对排序结果产生影响。 45 46可以利用HashSet不重复的特性，当需要不重复的集合或需要去重某个集合的时候使用。 47 48HashSet进行增、删、改、查操作的常用API如下： 49 50| 操作 | 描述 | 51| -------- | ------ | 52| 增加元素 | 通过add(value: T)函数每次在HashSet增加一个值。 | 53| 访问元素 | 通过values()返回一个迭代器对象，包含set中的所有value值。 | 54| 访问元素 | 通过entries()返回一个迭代器对象，包含类似键值对的数组，键值都是value。 | 55| 访问元素 | 通过forEach(callbackFn: (value?: T, key?: T, set?: HashSet\<T>) => void, thisArg?: Object)访问整个set的元素。 | 56| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 57| 修改元素 | 通过forEach(callbackFn: (value?: T, key?: T, set?: HashSet\<T>) => void, thisArg?: Object)对set中value进行修改操作。 | 58| 删除元素 | 通过remove(value: T)对set中匹配到的值进行删除操作。 | 59| 删除元素 | 通过clear()清空整个set集合。 | 60 61 62## TreeMap 63 64[TreeMap](../reference/apis-arkts/js-apis-treemap.md)可用来存储具有关联关系的key-value键值对集合，存储元素中key是唯一的，每个key会对应一个value值。 65 66TreeMap依据泛型定义，集合中的key值是有序的，TreeMap的底层是一棵二叉树，可以通过树的二叉查找快速的找到键值对。key的类型满足ECMA标准中要求的类型。TreeMap中的键值是有序存储的。TreeMap底层基于红黑树实现，可以进行快速的插入和删除。 67 68TreeMap和[HashMap](../reference/apis-arkts/js-apis-hashmap.md)相比，HashMap依据键的hashCode存取数据，访问速度较快。而TreeMap是有序存取，效率较低。 69 70一般需要存储有序键值对的场景，可以使用TreeMap。 71 72TreeMap进行增、删、改、查操作的常用API如下： 73 74| 操作 | 描述 | 75| ------- | ------ | 76| 增加元素 | 通过set(key: K,value: V)函数每次在TreeMap增加一个键值对。 | 77| 访问元素 | 通过get(key: K)获取key对应的value值。 | 78| 访问元素 | 通过getFirstKey()获取map中排在首位的key值。 | 79| 访问元素 | 通过getLastKey()获取map中排在未位的key值。 | 80| 访问元素 | 通过keys()返回一个迭代器对象，包含map中的所有key值。 | 81| 访问元素 | 通过values()返回一个迭代器对象，包含map中的所有value值。 | 82| 访问元素 | 通过entries()返回一个迭代器对象，包含map中的所有键值对。 | 83| 访问元素 | 通过forEach(callbackFn: (value?: V, key?: K, map?: TreeMap<K, V>) => void, thisArg?: Object)访问整个map的元素。 | 84| 访问元素 | 通过\[Symbol.iterator]():IterableIterator\<[K,V]>迭代器进行数据访问。 | 85| 修改元素 | 通过replace(key: K,newValue: V)对指定key对应的value值进行修改操作。 | 86| 修改元素 | 通过forEach(callbackFn: (value?: V, key?: K, map?: TreeMap<K, V>) => void, thisArg?: Object)对map中元素进行修改操作。 | 87| 删除元素 | 通过remove(key: K)对map中匹配到的键值对进行删除操作。 | 88| 删除元素 | 通过clear()清空整个map集合。 | 89 90 91## TreeSet 92 93[TreeSet](../reference/apis-arkts/js-apis-treeset.md)可用来存储一系列值的集合，存储元素中value是唯一的。 94 95TreeSet依据泛型定义，集合中的value值是有序的，TreeSet的底层是一棵二叉树，可以通过树的二叉查找快速的找到该value值，value的类型满足ECMA标准中要求的类型。TreeSet中的值是有序存储的。TreeSet底层基于红黑树实现，可以进行快速的插入和删除。 96 97TreeSet基于[TreeMap](../reference/apis-arkts/js-apis-treemap.md)实现，在TreeSet中，只对value对象进行处理。TreeSet可用于存储一系列值的集合，元素中value唯一且有序。 98 99TreeSet和[HashSet](../reference/apis-arkts/js-apis-hashset.md)相比，HashSet中的数据无序存放，而TreeSet是有序存放。它们集合中的元素都不允许重复，但HashSet允许放入null值，TreeSet不建议存放null值，可能会对排序结果产生影响。 100 101一般需要存储有序集合的场景，可以使用TreeSet。 102 103TreeSet进行增、删、改、查操作的常用API如下： 104 105| 操作 | 描述 | 106| -------- | ------ | 107| 增加元素 | 通过add(value: T)函数每次在TreeSet增加一个值。 | 108| 访问元素 | 通过values()返回一个迭代器对象，包含set中的所有value值。 | 109| 访问元素 | 通过entries()返回一个迭代器对象，包含类似键值对的数组，键值都是value。 | 110| 访问元素 | 通过getFirstValue()获取set中排在首位的value值。 | 111| 访问元素 | 通过getLastValue()获取set中排在未位的value值。 | 112| 访问元素 | 通过forEach(callbackFn: (value?: T, key?: T, set?: TreeSet\<T>) => void, thisArg?: Object)访问整个set的元素。 | 113| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 114| 修改元素 | 通过forEach(callbackFn: (value?: T, key?: T, set?: TreeSet\<T>) => void, thisArg?: Object)对set中value进行修改操作。 | 115| 删除元素 | 通过remove(value: T)对set中匹配到的值进行删除操作。 | 116| 删除元素 | 通过clear()清空整个set集合。 | 117 118 119## LightWeightMap 120 121[LightWeightMap](../reference/apis-arkts/js-apis-lightweightmap.md)可用来存储具有关联关系的key-value键值对集合，存储元素中key是唯一的，每个key会对应一个value值。LightWeightMap依据泛型定义，采用更加轻量级的结构，底层标识唯一key通过hash实现，其冲突策略为线性探测法。集合中的key值的查找依赖于hash值以及二分查找算法，通过一个数组存储hash值，然后映射到其他数组中的key值以及value值，key的类型满足ECMA标准中要求的类型。 122 123初始默认容量大小为8，每次扩容大小为原始容量的2倍。 124 125LightWeightMap和[HashMap](../reference/apis-arkts/js-apis-hashmap.md)都是用来存储键值对的集合，LightWeightMap占用内存更小。 126 127当需要存取key-value键值对时，推荐使用占用内存更小的LightWeightMap。 128 129LightWeightMap进行增、删、改、查操作的常用API如下： 130 131| 操作 | 描述 | 132| -------- | ------ | 133| 增加元素 | 通过set(key: K,value: V)函数每次在LightWeightMap增加一个键值对。 | 134| 访问元素 | 通过get(key: K)获取key对应的value值。 | 135| 访问元素 | 通过getIndexOfKey(key: K)获取map中指定key的index。 | 136| 访问元素 | 通过getIndexOfValue(value: V)获取map中指定value出现的第一个的index。 | 137| 访问元素 | 通过keys()返回一个迭代器对象，包含map中的所有key值。 | 138| 访问元素 | 通过values()返回一个迭代器对象，包含map中的所有value值。 | 139| 访问元素 | 通过entries()返回一个迭代器对象，包含map中的所有键值对。 | 140| 访问元素 | 通过getKeyAt(index: number)获取指定index对应的key值。 | 141| 访问元素 | 通过getValueAt(index: number)获取指定index对应的value值。 | 142| 访问元素 | 通过forEach(callbackFn: (value?: V, key?: K, map?: LightWeightMap<K, V>) => void, thisArg?: Object)访问整个map的元素。 | 143| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<[K,V]>迭代器进行数据访问。 | 144| 修改元素 | 通过setValueAt(index: number, newValue: V)对指定index对应的value值进行修改操作。 | 145| 修改元素 | 通过forEach(callbackFn: (value?: V, key?: K, map?: LightWeightMap<K, V>) => void, thisArg?: Object)对map中元素进行修改操作。 | 146| 删除元素 | 通过remove(key: K)对map中匹配到的键值对进行删除操作。 | 147| 删除元素 | 通过removeAt(index: number)对map中指定index的位置进行删除操作。 | 148| 删除元素 | 通过clear()清空整个map集合。 | 149 150 151## LightWeightSet 152 153[LightWeightSet](../reference/apis-arkts/js-apis-lightweightset.md)可用来存储一系列值的集合，存储元素中value是唯一的。 154 155LightWeightSet依据泛型定义，采用更加轻量级的结构，初始默认容量大小为8，每次扩容大小为原始容量的2倍。集合中的value值的查找依赖于hash以及二分查找算法，通过一个数组存储hash值，然后映射到其他数组中的value值，value的类型满足ECMA标准中要求的类型。 156 157LightWeightSet底层标识唯一value基于hash实现，其冲突策略为线性探测法，查找策略基于二分查找法。 158 159LightWeightSet和[HashSet](../reference/apis-arkts/js-apis-hashset.md)都是用来存储键值的集合，LightWeightSet的占用内存更小。 160 161当需要存取某个集合或是对某个集合去重时，推荐使用占用内存更小的LightWeightSet。 162 163LightWeightSet进行增、删、改、查操作的常用API如下： 164 165| 操作 | 描述 | 166| -------- | ------ | 167| 增加元素 | 通过add(obj: T)函数每次在LightWeightSet增加一个值。 | 168| 访问元素 | 通过getIndexOf(key: T)获取对应的index值。 | 169| 访问元素 | 通过values()返回一个迭代器对象，包含map中的所有value值。 | 170| 访问元素 | 通过entries()返回一个迭代器对象，包含map中的所有键值对。 | 171| 访问元素 | 通过getValueAt(index: number)获取指定index对应的value值。 | 172| 访问元素 | 通过forEach(callbackFn: (value?: T, key?: T, set?: LightWeightSet\<T>) => void, thisArg?: Object)访问整个set的元素。 | 173| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 174| 修改元素 | 通过forEach(callbackFn: (value?: T, key?: T, set?: LightWeightSet\<T>) => void, thisArg?: Object)对set中元素进行修改操作。 | 175| 删除元素 | 通过remove(key: K)对set中匹配到的键值对进行删除操作。 | 176| 删除元素 | 通过removeAt(index: number)对set中指定index的位置进行删除操作。 | 177| 删除元素 | 通过clear()清空整个set集合。 | 178 179 180## PlainArray 181 182[PlainArray](../reference/apis-arkts/js-apis-plainarray.md)可用来存储具有关联关系的键值对集合，存储元素中key是唯一的，并且对于PlainArray来说，其key的类型为number类型。每个key会对应一个value值，类型依据泛型的定义，PlainArray采用更加轻量级的结构，集合中的key值的查找依赖于二分查找算法，然后映射到其他数组中的value值。 183 184初始默认容量大小为16，每次扩容大小为原始容量的2倍。 185 186PlainArray和[LightWeightMap](../reference/apis-arkts/js-apis-lightweightmap.md)都是用来存储键值对，且均采用轻量级结构，但PlainArray的key值类型只能为number类型。 187 188当需要存储key值为number类型的键值对时，可以使用PlainArray。 189 190PlainArray进行增、删、改、查操作的常用API如下： 191 192| 操作 | 描述 | 193| -------- | ------ | 194| 增加元素 | 通过add(key: number,value: T)函数每次在PlainArray增加一个键值对。 | 195| 访问元素 | 通过get(key: number)获取key对应的value值。 | 196| 访问元素 | 通过getIndexOfKey(key: number)获取PlainArray中指定key的index。 | 197| 访问元素 | 通过getIndexOfValue(value: T)获取PlainArray中指定value的index。 | 198| 访问元素 | 通过getKeyAt(index: number)获取指定index对应的key值。 | 199| 访问元素 | 通过getValueAt(index: number)获取指定index对应的value值。 | 200| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, PlainArray?: PlainArray\<T>) => void, thisArg?: Object)访问整个plainarray的元素。 | 201| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<[number, T]>迭代器进行数据访问。 | 202| 修改元素 | 通过setValueAt(index:number, value: T)对指定index对应的value值进行修改操作。 | 203| 修改元素 | 通过forEach(callbackFn: (value: T, index?: number, PlainArray?: PlainArray\<T>) => void, thisArg?: Object)对plainarray中元素进行修改操作。 | 204| 删除元素 | 通过remove(key: number)对plainarray中匹配到的键值对进行删除操作。 | 205| 删除元素 | 通过removeAt(index: number)对plainarray中指定index的位置进行删除操作。 | 206| 删除元素 | 通过removeRangeFrom(index: number, size: number)对plainarray中指定范围内的元素进行删除操作。 | 207| 删除元素 | 通过clear()清空整个PlainArray集合。 | 208 209 210## 非线性容器的使用 211 212此处列举常用的非线性容器HashMap、TreeMap、LightWeightMap、PlainArray的使用示例，包括导入模块、增加元素、访问元素及修改等操作，示例代码如下所示： 213 214 215```ts 216// HashMap 217import HashMap from '@ohos.util.HashMap'; // 导入HashMap模块 218 219let hashMap1: HashMap<string, number> = new HashMap(); 220hashMap1.set('a', 123); 221let hashMap2: HashMap<number, number> = new HashMap(); 222hashMap2.set(4, 123); // 增加元素 223console.info(`result: ${hashMap2.hasKey(4)}`); // 判断是否含有某元素 224console.info(`result: ${hashMap1.get('a')}`); // 访问元素 225 226// TreeMap 227import TreeMap from '@ohos.util.TreeMap'; // 导入TreeMap模块 228 229let treeMap: TreeMap<string, number> = new TreeMap(); 230treeMap.set('a', 123); 231treeMap.set('6', 356); // 增加元素 232console.info(`result: ${treeMap.get('a')}`); // 访问元素 233console.info(`result: ${treeMap.getFirstKey()}`); // 访问首元素 234console.info(`result: ${treeMap.getLastKey()}`); // 访问尾元素 235 236// LightWeightMap 237import LightWeightMap from '@ohos.util.LightWeightMap'; // 导入LightWeightMap模块 238 239let lightWeightMap: LightWeightMap<string, number> = new LightWeightMap(); 240lightWeightMap.set('x', 123); 241lightWeightMap.set('8', 356); // 增加元素 242console.info(`result: ${lightWeightMap.get('a')}`); // 访问元素 243console.info(`result: ${lightWeightMap.get('x')}`); // 访问元素 244console.info(`result: ${lightWeightMap.getIndexOfKey('8')}`); // 访问元素 245 246// PlainArray 247import PlainArray from '@ohos.util.PlainArray' // 导入PlainArray模块 248 249let plainArray: PlainArray<string> = new PlainArray(); 250plainArray.add(1, 'sdd'); 251plainArray.add(2, 'sff'); // 增加元素 252console.info(`result: ${plainArray.get(1)}`); // 访问元素 253console.info(`result: ${plainArray.getKeyAt(1)}`); // 访问元素 254``` 255