1# 线性容器 2 3 4线性容器实现能按顺序访问的数据结构，其底层主要通过数组实现，包括ArrayList、Vector、List、LinkedList、Deque、Queue、Stack七种。 5 6 7线性容器，充分考虑了数据访问的速度，运行时（Runtime）通过一条字节码指令就可以完成增、删、改、查等操作。 8 9 10## ArrayList 11 12[ArrayList](../reference/apis-arkts/js-apis-arraylist.md)即动态数组，可用来构造全局的数组对象。 当需要频繁读取集合中的元素时，推荐使用ArrayList。 13 14ArrayList依据泛型定义，要求存储位置是一片连续的内存空间，初始容量大小为10，并支持动态扩容，每次扩容大小为原始容量的1.5倍。 15 16ArrayList进行增、删、改、查操作的常用API如下： 17 18| 操作 | 描述 | 19| --------- | ------- | 20| 增加元素 | 通过add(element: T)函数每次在数组尾部增加一个元素。 | 21| 增加元素 | 通过insert(element: T, index: number)在指定位置插入一个元素。 | 22| 访问元素 | 通过arr\[index]获取指定index对应的value值，通过指令获取保证访问速度。 | 23| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, arrlist?: ArrayList<T>) => void, thisArg?: Object): void访问整个ArrayList容器的元素。 | 24| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 25| 修改元素 | 通过arr\[index] = xxx修改指定index位置对应的value值。 | 26| 删除元素 | 通过remove(element: T)删除第一个匹配到的元素。 | 27| 删除元素 | 通过removeByRange(fromIndex: number, toIndex:number)删除指定范围内的元素。 | 28 29 30## Vector 31 32> **说明**： 33> 34> API version 9开始，该接口不再维护，推荐使用[ArrayList](../reference/apis-arkts/js-apis-arraylist.md)。 35 36[Vector](../reference/apis-arkts/js-apis-vector.md)是指连续存储结构，可用来构造全局的数组对象。Vector依据泛型定义，要求存储位置是一片连续的内存空间，初始容量大小为10，并支持动态扩容，每次扩容大小为原始容量的2倍。 37 38Vector和[ArrayList](../reference/apis-arkts/js-apis-arraylist.md)相似，都是基于数组实现，但Vector提供了更多操作数组的接口。Vector在支持操作符访问的基础上，还增加了get/set接口，提供更为完善的校验及容错机制，满足用户不同场景下的需求。 39 40Vector进行增、删、改、查操作的常用API如下： 41 42| 操作 | 描述 | 43| --------- | ------- | 44| 增加元素 | 通过add(element: T)函数每次在数组尾部增加一个元素。 | 45| 增加元素 | 通过insert(element: T, index: number)在指定位置插入一个元素。 | 46| 访问元素 | 通过vec\[index]获取指定index对应的value值，通过指令获取保证访问速度。 | 47| 访问元素 | 通过get(index: number)获取指定index位置对应的元素。 | 48| 访问元素 | 通过getLastElement()获取最后一个元素。 | 49| 访问元素 | 通过getIndexOf(element:T)获取第一个匹配到元素的位置。 | 50| 访问元素 | 通过getLastIndexOf(element:T)获取最后一个匹配到元素的位置。 | 51| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, Vector?: Vector<T>) => void, thisArg?: Object)访问整个Vector的元素。 | 52| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 53| 修改元素 | 通过vec\[index]=xxx修改指定index位置对应的value值。 | 54| 修改元素 | 通过set(index:number,element:T)修改指定index位置的元素值为element。 | 55| 修改元素 | 通过setLength(newSize:number)设置Vector的长度大小。 | 56| 删除元素 | 通过removeByIndex(index:number)删除index位置对应的value值。 | 57| 删除元素 | 通过remove(element:T)删除第一个匹配到的元素。 | 58| 删除元素 | 通过removeByRange(fromIndex:number,toIndex:number)删除指定范围内的元素。 | 59 60 61## List 62 63[List](../reference/apis-arkts/js-apis-list.md)可用来构造一个单向链表对象，即只能通过头结点开始访问到尾节点。List依据泛型定义，在内存中的存储位置可以是不连续的。 64 65List和[LinkedList](../reference/apis-arkts/js-apis-linkedlist.md)相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。 66 67当需要频繁的插入删除时，推荐使用List高效操作。 68 69可以通过get/set等接口对存储的元素进行修改，List进行增、删、改、查操作的常用API如下： 70 71| 操作 | 描述 | 72| --------- | ------ | 73| 增加元素 | 通过add(element: T)函数每次在数组尾部增加一个元素。 | 74| 增加元素 | 通过insert(element: T, index: number)在指定位置插入一个元素。 | 75| 访问元素 | 通过list\[index]获取指定index对应的value值，通过指令获取保证访问速度。 | 76| 访问元素 | 通过get(index: number)获取指定index位置对应的元素。 | 77| 访问元素 | 通过getFirst()获取第一个元素。 | 78| 访问元素 | 通过getLast()获取最后一个元素。 | 79| 访问元素 | 通过getIndexOf(element: T)获取第一个匹配到元素的位置。 | 80| 访问元素 | 通过getLastIndexOf(element: T)获取最后一个匹配到元素的位置。 | 81| 访问元素 | 通过forEach(callbackfn: (value:T, index?: number, list?: List<T>)=> void,thisArg?: Object)访问整个List的元素。 | 82| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 83| 修改元素 | 通过list\[index] = xxx修改指定index位置对应的value值。 | 84| 修改元素 | 通过set(index:number, element: T)修改指定index位置的元素值为element。 | 85| 修改元素 | 通过replaceAllElements(callbackFn:(value: T,index?: number,list?: List<T>)=>T,thisArg?: Object)对List内元素进行替换操作。 | 86| 删除元素 | 通过removeByIndex(index:number)删除index位置对应的value值。 | 87| 删除元素 | 通过remove(element:T)删除第一个匹配到的元素。 | 88 89 90## LinkedList 91 92[LinkedList](../reference/apis-arkts/js-apis-linkedlist.md)可用来构造一个双向链表对象，可以在某一节点向前或者向后遍历List。LinkedList依据泛型定义，在内存中的存储位置可以是不连续的。 93 94LinkedList和[List](../reference/apis-arkts/js-apis-list.md)相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。 95 96LinkedList和[ArrayList](../reference/apis-arkts/js-apis-arraylist.md)相比，插入数据效率LinkedList优于ArrayList，而查询效率ArrayList优于LinkedList。 97 98当需要频繁的插入删除时，推荐使用LinkedList高效操作。 99 100可以通过get/set等接口对存储的元素进行修改，LinkedList进行增、删、改、查操作的常用API如下： 101 102| 操作 | 描述 | 103| ---------- | ------ | 104| 增加元素 | 通过add(element: T)函数每次在数组尾部增加一个元素。 | 105| 增加元素 | 通过insert(index: number, element: T)在指定位置插入一个元素。 | 106| 访问元素 | 通过list\[index]获取指定index对应的value值，通过指令获取保证访问速度。 | 107| 访问元素 | 通过get(index: number)获取指定index位置对应的元素。 | 108| 访问元素 | 通过getFirst()获取第一个元素。 | 109| 访问元素 | 通过getLast()获取最后一个元素。 | 110| 访问元素 | 通过getIndexOf(element: T)获取第一个匹配到元素的位置。 | 111| 访问元素 | 通过getLastIndexOf(element: T)获取最后一个匹配到元素的位置。 | 112| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, list?: LinkedList<T>) => void, thisArg?: Object)访问整个LinkedList的元素。 | 113| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 114| 修改元素 | 通过list\[index]=xxx修改指定index位置对应的value值。 | 115| 修改元素 | 通过set(index: number,element: T)修改指定index位置的元素值为element。 | 116| 删除元素 | 通过removeByIndex(index: number)删除index位置对应的value值。 | 117| 删除元素 | 通过remove(element: T)删除第一个匹配到的元素。 | 118 119 120## Deque 121 122[Deque](../reference/apis-arkts/js-apis-deque.md)可用来构造双端队列对象，存储元素遵循先进先出以及先进后出的规则，双端队列可以分别从队头或者队尾进行访问。 123 124Deque依据泛型定义，要求存储位置是一片连续的内存空间，其初始容量大小为8，并支持动态扩容，每次扩容大小为原始容量的2倍。Deque底层采用循环队列实现，入队及出队操作效率都比较高。 125 126Deque和[Queue](../reference/apis-arkts/js-apis-queue.md)相比，Queue的特点是先进先出，只能在头部删除元素，尾部增加元素。 127 128Deque和[Vector](../reference/apis-arkts/js-apis-vector.md)相比，它们都支持在两端增删元素，但Deque不能进行中间插入的操作。对头部元素的插入删除效率高于Vector，而Vector访问元素的效率高于Deque。 129 130需要频繁在集合两端进行增删元素的操作时，推荐使用Deque。 131 132Deque进行增、删、改、查操作的常用API如下： 133 134| 操作 | 描述 | 135| ---------- | ------ | 136| 增加元素 | 通过insertFront(element: T)函数每次在队头增加一个元素。 | 137| 增加元素 | 通过insertEnd(element: T)函数每次在队尾增加一个元素。 | 138| 访问元素 | 通过getFirst()获取队首元素的value值，但是不进行出队操作。 | 139| 访问元素 | 通过getLast()获取队尾元素的value值，但是不进行出队操作。 | 140| 访问元素 | 通过popFirst()获取队首元素的value值，并进行出队操作。 | 141| 访问元素 | 通过popLast()获取队尾元素的value值，并进行出队操作。 | 142| 访问元素 | 通过forEach(callbackFn:(value: T, index?: number, deque?: Deque<T>) => void, thisArg?: Object)访问整个Deque的元素。 | 143| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 144| 修改元素 | 通过forEach(callbackFn:(value: T, index?: number, deque?: Deque<T>)=> void, thisArg?: Object)对队列进行修改操作。 | 145| 删除元素 | 通过popFirst()对队首元素进行出队操作并删除。 | 146| 删除元素 | 通过popLast()对队尾元素进行出队操作并删除。 | 147 148 149## Queue 150 151[Queue](../reference/apis-arkts/js-apis-queue.md)可用来构造队列对象，存储元素遵循先进先出的规则。 152 153Queue依据泛型定义，要求存储位置是一片连续的内存空间，初始容量大小为8，并支持动态扩容，每次扩容大小为原始容量的2倍。 154 155Queue底层采用循环队列实现，入队及出队操作效率都比较高。 156 157Queue和[Deque](../reference/apis-arkts/js-apis-deque.md)相比，Queue只能在一端删除一端增加，Deque可以两端增删。 158 159一般符合先进先出的场景可以使用Queue。 160 161Queue进行增、删、改、查操作的常用API如下： 162 163| 操作 | 描述 | 164| ---------- | ------ | 165| 增加元素 | 通过add(element: T)函数每次在队尾增加一个元素。 | 166| 访问元素 | 通过getFirst()获取队首元素的value值，但是不进行出队操作。 | 167| 访问元素 | 通过pop()获取队首元素的value值，并进行出队操作。 | 168| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, queue?: Queue<T>) => void,thisArg?: Object)访问整个Queue的元素。 | 169| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 170| 修改元素 | 通过forEach(callbackFn:(value: T, index?: number, queue?: Queue<T>) => void,thisArg?: Object)对队列进行修改操作。 | 171| 删除元素 | 通过pop()对队首进行出队操作并删除。 | 172 173 174## Stack 175 176[Stack](../reference/apis-arkts/js-apis-stack.md)可用来构造栈对象，存储元素遵循先进后出的规则。 177 178Stack依据泛型定义，要求存储位置是一片连续的内存空间，初始容量大小为8，并支持动态扩容，每次扩容大小为原始容量的1.5倍。Stack底层基于数组实现，入栈出栈均从数组的一端操作。 179 180Stack和[Queue](../reference/apis-arkts/js-apis-queue.md)相比，Queue基于循环队列实现，只能在一端删除，另一端插入，而Stack都在一端操作。 181 182一般符合先进后出的场景可以使用Stack。 183 184Stack进行增、删、改、查操作的常用API如下： 185 186| 操作 | 描述 | 187| ---------- | ------ | 188| 增加元素 | 通过push(item: T)函数每次在栈顶增加一个元素。 | 189| 访问元素 | 通过peek()获取栈顶元素的value值，但是不进行出栈操作。 | 190| 访问元素 | 通过pop()获取栈顶的value值，并进行出栈操作。 | 191| 访问元素 | 通过forEach(callbackFn: (value: T, index?: number, stack?: Stack<T>) => void, thisArg?: Object)访问整个Stack的元素。 | 192| 访问元素 | 通过\[Symbol.iterator]():IterableIterator<T>迭代器进行数据访问。 | 193| 访问元素 | 通过locate(element: T)获取元素对应的位置。 | 194| 修改元素 | 通过forEach(callbackFn:(value: T, index?: number, stack?: Stack<T>) => void, thisArg?: Object)对栈内元素进行修改操作。 | 195| 删除元素 | 通过pop()对栈顶进行出栈操作并删除。 | 196 197 198## 线性容器的使用 199 200此处列举常用的线性容器ArrayList、Vector、Deque、Stack、List的使用示例，包括导入模块、增加元素、访问元素及修改等操作。示例代码如下所示： 201 202 203```ts 204// ArrayList 205import ArrayList from '@ohos.util.ArrayList'; // 导入ArrayList模块 206 207let arrayList1: ArrayList<string> = new ArrayList(); 208arrayList1.add('a'); 209let arrayList2: ArrayList<number> = new ArrayList(); 210arrayList2.add(1); // 增加元素 211console.info(`result: ${arrayList2[0]}`); // 访问元素 212arrayList1[0] = 'one'; // 修改元素 213console.info(`result: ${arrayList1[0]}`); 214 215// Vector 216import Vector from '@ohos.util.Vector'; // 导入Vector模块 217 218let vector1: Vector<string> = new Vector(); 219vector1.add('a'); 220let vector2: Vector<Array<number>> = new Vector(); 221let b1 = [1, 2, 3]; 222vector2.add(b1); 223let vector3: Vector<boolean> = new Vector(); 224vector3.add(false); // 增加元素 225console.info(`result: ${vector1[0]}`); // 访问元素 226console.info(`result: ${vector2.getFirstElement()}`); // 访问元素 227 228// Deque 229import Deque from '@ohos.util.Deque'; // 导入Deque模块 230 231let deque1: Deque<string> = new Deque(); 232deque1.insertFront('a'); 233let deque2: Deque<number> = new Deque(); 234deque2.insertFront(1); // 增加元素 235console.info(`result: ${deque1[0]}`); // 访问元素 236deque1[0] = 'one'; // 修改元素 237console.info(`result: ${deque2[0]}`); 238 239// Stack 240import Stack from '@ohos.util.Stack'; // 导入Stack模块 241 242let stack1: Stack<string> = new Stack(); 243stack1.push('a'); 244let stack2: Stack<number> = new Stack(); 245stack2.push(1); // 增加元素 246console.info(`result: ${stack1[0]}`); // 访问元素 247stack2.pop(); // 删除栈顶元素并返回该删除元素 248console.info(`result: ${stack2.length}`); 249 250// List 251import List from '@ohos.util.List'; // 导入List模块 252 253let list1: List<string> = new List(); 254list1.add('a'); 255let list2: List<number> = new List(); 256list2.add(1); 257let list3: List<Array<number>> = new List(); 258let b2 = [1, 2, 3]; 259list3.add(b2); // 增加元素 260console.info(`result: ${list1[0]}`); // 访问元素 261console.info(`result: ${list3.get(0)}`); // 访问元素 262``` 263