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