data-structure-typed 1.42.4 → 1.42.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1 -1
- package/CONTRIBUTING.md +66 -5
- package/README.md +212 -120
- package/benchmark/report.html +12 -12
- package/benchmark/report.json +106 -106
- package/dist/cjs/src/data-structures/binary-tree/index.d.ts +1 -1
- package/dist/cjs/src/data-structures/binary-tree/index.js +1 -1
- package/dist/cjs/src/data-structures/binary-tree/{tree-multiset.d.ts → tree-multimap.d.ts} +10 -10
- package/dist/cjs/src/data-structures/binary-tree/{tree-multiset.js → tree-multimap.js} +15 -15
- package/dist/cjs/src/data-structures/binary-tree/{tree-multiset.js.map → tree-multimap.js.map} +1 -1
- package/dist/cjs/src/types/data-structures/binary-tree/index.d.ts +1 -1
- package/dist/cjs/src/types/data-structures/binary-tree/index.js +1 -1
- package/dist/cjs/src/types/data-structures/binary-tree/tree-multimap.d.ts +4 -0
- package/dist/cjs/src/types/data-structures/binary-tree/{tree-multiset.js → tree-multimap.js} +1 -1
- package/dist/cjs/src/types/data-structures/binary-tree/tree-multimap.js.map +1 -0
- package/dist/mjs/src/data-structures/binary-tree/index.d.ts +1 -1
- package/dist/mjs/src/data-structures/binary-tree/index.js +1 -1
- package/dist/mjs/src/data-structures/binary-tree/{tree-multiset.d.ts → tree-multimap.d.ts} +10 -10
- package/dist/mjs/src/data-structures/binary-tree/{tree-multiset.js → tree-multimap.js} +14 -14
- package/dist/mjs/src/types/data-structures/binary-tree/index.d.ts +1 -1
- package/dist/mjs/src/types/data-structures/binary-tree/index.js +1 -1
- package/dist/mjs/src/types/data-structures/binary-tree/tree-multimap.d.ts +4 -0
- package/dist/umd/data-structure-typed.min.js +1 -1
- package/dist/umd/data-structure-typed.min.js.map +1 -1
- package/package.json +9 -7
- package/src/data-structures/binary-tree/index.ts +1 -1
- package/src/data-structures/binary-tree/{tree-multiset.ts → tree-multimap.ts} +14 -14
- package/src/types/data-structures/binary-tree/index.ts +1 -1
- package/src/types/data-structures/binary-tree/tree-multimap.ts +6 -0
- package/test/performance/data-structures/binary-tree/rb-tree.test.ts +2 -2
- package/test/performance/reportor.ts +2 -2
- package/test/unit/data-structures/binary-tree/{tree-multiset.test.ts → tree-multimap.test.ts} +182 -182
- package/dist/cjs/src/types/data-structures/binary-tree/tree-multiset.d.ts +0 -4
- package/dist/cjs/src/types/data-structures/binary-tree/tree-multiset.js.map +0 -1
- package/dist/mjs/src/types/data-structures/binary-tree/tree-multiset.d.ts +0 -4
- package/src/types/data-structures/binary-tree/tree-multiset.ts +0 -6
- /package/dist/mjs/src/types/data-structures/binary-tree/{tree-multiset.js → tree-multimap.js} +0 -0
- /package/test/performance/data-structures/binary-tree/{tree-multiset.test.ts → tree-multimap.test.ts} +0 -0
package/README.md
CHANGED
|
@@ -27,8 +27,105 @@ Now you can use this library in Node.js and browser environments in CommonJS(req
|
|
|
27
27
|
|
|
28
28
|
## Built-in classic algorithms
|
|
29
29
|
|
|
30
|
-
|
|
31
|
-
|
|
30
|
+
<table>
|
|
31
|
+
<thead>
|
|
32
|
+
<tr>
|
|
33
|
+
<th>Algorithm</th>
|
|
34
|
+
<th>Function Description</th>
|
|
35
|
+
<th>Iteration Type</th>
|
|
36
|
+
</tr>
|
|
37
|
+
</thead>
|
|
38
|
+
<tbody>
|
|
39
|
+
<tr>
|
|
40
|
+
<td>Binary Tree DFS</td>
|
|
41
|
+
<td>Traverse a binary tree in a depth-first manner, starting from the root node, first visiting the left subtree,
|
|
42
|
+
and then the right subtree, using recursion.
|
|
43
|
+
</td>
|
|
44
|
+
<td>Recursion + Iteration</td>
|
|
45
|
+
</tr>
|
|
46
|
+
<tr>
|
|
47
|
+
<td>Binary Tree BFS</td>
|
|
48
|
+
<td>Traverse a binary tree in a breadth-first manner, starting from the root node, visiting nodes level by level
|
|
49
|
+
from left to right.
|
|
50
|
+
</td>
|
|
51
|
+
<td>Iteration</td>
|
|
52
|
+
</tr>
|
|
53
|
+
<tr>
|
|
54
|
+
<td>Graph DFS</td>
|
|
55
|
+
<td>Traverse a graph in a depth-first manner, starting from a given node, exploring along one path as deeply as
|
|
56
|
+
possible, and backtracking to explore other paths. Used for finding connected components, paths, etc.
|
|
57
|
+
</td>
|
|
58
|
+
<td>Recursion + Iteration</td>
|
|
59
|
+
</tr>
|
|
60
|
+
<tr>
|
|
61
|
+
<td>Binary Tree Morris</td>
|
|
62
|
+
<td>Morris traversal is an in-order traversal algorithm for binary trees with O(1) space complexity. It allows tree
|
|
63
|
+
traversal without additional stack or recursion.
|
|
64
|
+
</td>
|
|
65
|
+
<td>Iteration</td>
|
|
66
|
+
</tr>
|
|
67
|
+
<tr>
|
|
68
|
+
<td>Graph BFS</td>
|
|
69
|
+
<td>Traverse a graph in a breadth-first manner, starting from a given node, first visiting nodes directly connected
|
|
70
|
+
to the starting node, and then expanding level by level. Used for finding shortest paths, etc.
|
|
71
|
+
</td>
|
|
72
|
+
<td>Recursion + Iteration</td>
|
|
73
|
+
</tr>
|
|
74
|
+
<tr>
|
|
75
|
+
<td>Graph Tarjan's Algorithm</td>
|
|
76
|
+
<td>Find strongly connected components in a graph, typically implemented using depth-first search.</td>
|
|
77
|
+
<td>Recursion</td>
|
|
78
|
+
</tr>
|
|
79
|
+
<tr>
|
|
80
|
+
<td>Graph Bellman-Ford Algorithm</td>
|
|
81
|
+
<td>Finding the shortest paths from a single source, can handle negative weight edges</td>
|
|
82
|
+
<td>Iteration</td>
|
|
83
|
+
</tr>
|
|
84
|
+
<tr>
|
|
85
|
+
<td>Graph Dijkstra's Algorithm</td>
|
|
86
|
+
<td>Finding the shortest paths from a single source, cannot handle negative weight edges</td>
|
|
87
|
+
<td>Iteration</td>
|
|
88
|
+
</tr>
|
|
89
|
+
<tr>
|
|
90
|
+
<td>Graph Floyd-Warshall Algorithm</td>
|
|
91
|
+
<td>Finding the shortest paths between all pairs of nodes</td>
|
|
92
|
+
<td>Iteration</td>
|
|
93
|
+
</tr>
|
|
94
|
+
<tr>
|
|
95
|
+
<td>Graph getCycles</td>
|
|
96
|
+
<td>Find all cycles in a graph or detect the presence of cycles.</td>
|
|
97
|
+
<td>Recursion</td>
|
|
98
|
+
</tr>
|
|
99
|
+
<tr>
|
|
100
|
+
<td>Graph getCutVertexes</td>
|
|
101
|
+
<td>Find cut vertices in a graph, which are nodes that, when removed, increase the number of connected components in
|
|
102
|
+
the graph.
|
|
103
|
+
</td>
|
|
104
|
+
<td>Recursion</td>
|
|
105
|
+
</tr>
|
|
106
|
+
<tr>
|
|
107
|
+
<td>Graph getSCCs</td>
|
|
108
|
+
<td>Find strongly connected components in a graph, which are subgraphs where any two nodes can reach each other.
|
|
109
|
+
</td>
|
|
110
|
+
<td>Recursion</td>
|
|
111
|
+
</tr>
|
|
112
|
+
<tr>
|
|
113
|
+
<td>Graph getBridges</td>
|
|
114
|
+
<td>Find bridges in a graph, which are edges that, when removed, increase the number of connected components in the
|
|
115
|
+
graph.
|
|
116
|
+
</td>
|
|
117
|
+
<td>Recursion</td>
|
|
118
|
+
</tr>
|
|
119
|
+
<tr>
|
|
120
|
+
<td>Graph topologicalSort</td>
|
|
121
|
+
<td>Perform topological sorting on a directed acyclic graph (DAG) to find a linear order of nodes such that all
|
|
122
|
+
directed edges go from earlier nodes to later nodes.
|
|
123
|
+
</td>
|
|
124
|
+
<td>Recursion</td>
|
|
125
|
+
</tr>
|
|
126
|
+
</tbody>
|
|
127
|
+
</table>
|
|
128
|
+
|
|
32
129
|
|
|
33
130
|
## Installation and Usage
|
|
34
131
|
|
|
@@ -47,23 +144,24 @@ yarn add data-structure-typed
|
|
|
47
144
|
```js
|
|
48
145
|
import {
|
|
49
146
|
BinaryTree, Graph, Queue, Stack, PriorityQueue, BST, Trie, DoublyLinkedList,
|
|
50
|
-
AVLTree, MinHeap, SinglyLinkedList, DirectedGraph,
|
|
147
|
+
AVLTree, MinHeap, SinglyLinkedList, DirectedGraph, TreeMultimap,
|
|
51
148
|
DirectedVertex, AVLTreeNode
|
|
52
149
|
} from 'data-structure-typed';
|
|
53
150
|
```
|
|
54
151
|
|
|
55
152
|
### CDN
|
|
56
153
|
|
|
154
|
+
Copy the line below into the head tag in an HTML document.
|
|
57
155
|
```html
|
|
58
|
-
|
|
59
156
|
<script src='https://cdn.jsdelivr.net/npm/data-structure-typed/dist/umd/data-structure-typed.min.js'></script>
|
|
60
157
|
```
|
|
61
158
|
|
|
159
|
+
Copy the code below into the script tag of your HTML, and you're good to go with your development work.
|
|
62
160
|
```js
|
|
63
161
|
const {Heap} = dataStructureTyped;
|
|
64
162
|
const {
|
|
65
163
|
BinaryTree, Graph, Queue, Stack, PriorityQueue, BST, Trie, DoublyLinkedList,
|
|
66
|
-
AVLTree, MinHeap, SinglyLinkedList, DirectedGraph,
|
|
164
|
+
AVLTree, MinHeap, SinglyLinkedList, DirectedGraph, TreeMultimap,
|
|
67
165
|
DirectedVertex, AVLTreeNode
|
|
68
166
|
} = dataStructureTyped;
|
|
69
167
|
```
|
|
@@ -71,7 +169,7 @@ const {
|
|
|
71
169
|
|
|
72
170
|
|
|
73
171
|
|
|
74
|
-
|
|
75
173
|
|
|
76
174
|
|
|
77
175
|
|
|
@@ -84,7 +182,7 @@ const {
|
|
|
84
182
|
|
|
85
183
|
<a href="https://github.com/zrwusa/vivid-algorithm" target="_blank">Examples Repository</a>
|
|
86
184
|
|
|
87
|
-
## Code
|
|
185
|
+
## Code Snippets
|
|
88
186
|
|
|
89
187
|
### Binary Search Tree (BST) snippet
|
|
90
188
|
|
|
@@ -99,27 +197,40 @@ bst.add(3);
|
|
|
99
197
|
bst.addMany([15, 1, 8, 13, 16, 2, 6, 9, 12, 14, 4, 7, 10, 5]);
|
|
100
198
|
bst.size === 16; // true
|
|
101
199
|
bst.has(6); // true
|
|
102
|
-
const node6 = bst.
|
|
200
|
+
const node6 = bst.getNode(6); // BSTNode
|
|
103
201
|
bst.getHeight(6) === 2; // true
|
|
104
202
|
bst.getHeight() === 5; // true
|
|
105
203
|
bst.getDepth(6) === 3; // true
|
|
106
204
|
|
|
107
|
-
bst.getLeftMost()?.
|
|
205
|
+
bst.getLeftMost()?.key === 1; // true
|
|
108
206
|
|
|
109
207
|
bst.delete(6);
|
|
110
|
-
bst.get(6); //
|
|
208
|
+
bst.get(6); // undefined
|
|
111
209
|
bst.isAVLBalanced(); // true
|
|
112
210
|
bst.bfs()[0] === 11; // true
|
|
113
211
|
|
|
114
|
-
const objBST = new BST<
|
|
115
|
-
|
|
116
|
-
objBST.add(
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
212
|
+
const objBST = new BST<{height: number, age: number}>();
|
|
213
|
+
|
|
214
|
+
objBST.add(11, { "name": "Pablo", "age": 15 });
|
|
215
|
+
objBST.add(3, { "name": "Kirk", "age": 1 });
|
|
216
|
+
|
|
217
|
+
objBST.addMany([15, 1, 8, 13, 16, 2, 6, 9, 12, 14, 4, 7, 10, 5], [
|
|
218
|
+
{ "name": "Alice", "age": 15 },
|
|
219
|
+
{ "name": "Bob", "age": 1 },
|
|
220
|
+
{ "name": "Charlie", "age": 8 },
|
|
221
|
+
{ "name": "David", "age": 13 },
|
|
222
|
+
{ "name": "Emma", "age": 16 },
|
|
223
|
+
{ "name": "Frank", "age": 2 },
|
|
224
|
+
{ "name": "Grace", "age": 6 },
|
|
225
|
+
{ "name": "Hannah", "age": 9 },
|
|
226
|
+
{ "name": "Isaac", "age": 12 },
|
|
227
|
+
{ "name": "Jack", "age": 14 },
|
|
228
|
+
{ "name": "Katie", "age": 4 },
|
|
229
|
+
{ "name": "Liam", "age": 7 },
|
|
230
|
+
{ "name": "Mia", "age": 10 },
|
|
231
|
+
{ "name": "Noah", "age": 5 }
|
|
232
|
+
]
|
|
233
|
+
);
|
|
123
234
|
|
|
124
235
|
objBST.delete(11);
|
|
125
236
|
```
|
|
@@ -133,39 +244,21 @@ const bst = new BST();
|
|
|
133
244
|
bst.add(11);
|
|
134
245
|
bst.add(3);
|
|
135
246
|
bst.addMany([15, 1, 8, 13, 16, 2, 6, 9, 12, 14, 4, 7, 10, 5]);
|
|
136
|
-
bst.size === 16;
|
|
137
|
-
bst.has(6);
|
|
138
|
-
const node6 = bst.
|
|
139
|
-
bst.getHeight(6) === 2;
|
|
140
|
-
bst.getHeight() === 5;
|
|
141
|
-
bst.getDepth(6) === 3;
|
|
247
|
+
bst.size === 16; // true
|
|
248
|
+
bst.has(6); // true
|
|
249
|
+
const node6 = bst.getNode(6);
|
|
250
|
+
bst.getHeight(6) === 2; // true
|
|
251
|
+
bst.getHeight() === 5; // true
|
|
252
|
+
bst.getDepth(6) === 3; // true
|
|
142
253
|
const leftMost = bst.getLeftMost();
|
|
143
|
-
leftMost?.
|
|
144
|
-
|
|
254
|
+
leftMost?.key === 1; // true
|
|
255
|
+
|
|
145
256
|
bst.delete(6);
|
|
146
|
-
bst.get(6);
|
|
147
|
-
bst.isAVLBalanced();
|
|
257
|
+
bst.get(6); // undefined
|
|
258
|
+
bst.isAVLBalanced(); // true or false
|
|
148
259
|
const bfsIDs = bst.bfs();
|
|
149
|
-
bfsIDs[0] === 11;
|
|
150
|
-
expect(bfsIDs[0]).toBe(11);
|
|
260
|
+
bfsIDs[0] === 11; // true
|
|
151
261
|
|
|
152
|
-
const objBST = new BST();
|
|
153
|
-
objBST.add(11, {id: 11, keyA: 11});
|
|
154
|
-
objBST.add(3, {id: 3, keyA: 3});
|
|
155
|
-
|
|
156
|
-
objBST.addMany([{id: 15, keyA: 15}, {id: 1, keyA: 1}, {id: 8, keyA: 8},
|
|
157
|
-
{id: 13, keyA: 13}, {id: 16, keyA: 16}, {id: 2, keyA: 2},
|
|
158
|
-
{id: 6, keyA: 6}, {id: 9, keyA: 9}, {id: 12, keyA: 12},
|
|
159
|
-
{id: 14, keyA: 14}, {id: 4, keyA: 4}, {id: 7, keyA: 7},
|
|
160
|
-
{id: 10, keyA: 10}, {id: 5, keyA: 5}]);
|
|
161
|
-
|
|
162
|
-
objBST.delete(11);
|
|
163
|
-
|
|
164
|
-
const avlTree = new AVLTree();
|
|
165
|
-
avlTree.addMany([11, 3, 15, 1, 8, 13, 16, 2, 6, 9, 12, 14, 4, 7, 10, 5])
|
|
166
|
-
avlTree.isAVLBalanced(); // true
|
|
167
|
-
avlTree.delete(10);
|
|
168
|
-
avlTree.isAVLBalanced(); // true
|
|
169
262
|
```
|
|
170
263
|
|
|
171
264
|
### AVLTree snippet
|
|
@@ -222,7 +315,7 @@ graph.addVertex('C');
|
|
|
222
315
|
graph.addEdge('A', 'B');
|
|
223
316
|
graph.addEdge('B', 'C');
|
|
224
317
|
|
|
225
|
-
const
|
|
318
|
+
const topologicalOrderKeys = graph.topologicalSort(); // ['A', 'B', 'C']
|
|
226
319
|
```
|
|
227
320
|
|
|
228
321
|
### Undirected Graph snippet
|
|
@@ -242,7 +335,7 @@ graph.addEdge('A', 'B');
|
|
|
242
335
|
graph.addEdge('B', 'D');
|
|
243
336
|
|
|
244
337
|
const dijkstraResult = graph.dijkstra('A');
|
|
245
|
-
Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.
|
|
338
|
+
Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.key) // ['A', 'B', 'D']
|
|
246
339
|
```
|
|
247
340
|
|
|
248
341
|
## Data Structures
|
|
@@ -290,7 +383,7 @@ Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.id) // ['A', 'B', 'D
|
|
|
290
383
|
<td>Tree Multiset</td>
|
|
291
384
|
<td><img src="https://raw.githubusercontent.com/zrwusa/assets/master/images/data-structure-typed/assets/tick.svg" alt=""></td>
|
|
292
385
|
<td><img src="https://raw.githubusercontent.com/zrwusa/assets/master/images/data-structure-typed/assets/tick.svg" alt=""></td>
|
|
293
|
-
<td><a href="https://data-structure-typed-docs.vercel.app/classes/
|
|
386
|
+
<td><a href="https://data-structure-typed-docs.vercel.app/classes/TreeMultimap.html"><span>TreeMultimap</span></a></td>
|
|
294
387
|
<td><img src="https://raw.githubusercontent.com/zrwusa/assets/master/images/data-structure-typed/assets/tick.svg" alt=""></td>
|
|
295
388
|
</tr>
|
|
296
389
|
<tr>
|
|
@@ -444,12 +537,6 @@ Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.id) // ['A', 'B', 'D
|
|
|
444
537
|
</tr>
|
|
445
538
|
</thead>
|
|
446
539
|
<tbody>
|
|
447
|
-
<tr>
|
|
448
|
-
<td>Array<E></td>
|
|
449
|
-
<td>vector<T></td>
|
|
450
|
-
<td>ArrayList<E></td>
|
|
451
|
-
<td>list</td>
|
|
452
|
-
</tr>
|
|
453
540
|
<tr>
|
|
454
541
|
<td>DoublyLinkedList<E></td>
|
|
455
542
|
<td>list<T></td>
|
|
@@ -463,30 +550,23 @@ Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.id) // ['A', 'B', 'D
|
|
|
463
550
|
<td>-</td>
|
|
464
551
|
</tr>
|
|
465
552
|
<tr>
|
|
466
|
-
<td>
|
|
467
|
-
<td>
|
|
468
|
-
<td>
|
|
469
|
-
<td>
|
|
470
|
-
</tr>
|
|
471
|
-
<tr>
|
|
472
|
-
<td>Map<K, V></td>
|
|
473
|
-
<td>map<K, V></td>
|
|
474
|
-
<td>HashMap<K, V></td>
|
|
475
|
-
<td>dict</td>
|
|
476
|
-
</tr>
|
|
477
|
-
<tr>
|
|
478
|
-
<td>Map<K, V></td>
|
|
479
|
-
<td>-</td>
|
|
480
|
-
<td>-</td>
|
|
481
|
-
<td>OrderedDict</td>
|
|
553
|
+
<td>Array<E></td>
|
|
554
|
+
<td>vector<T></td>
|
|
555
|
+
<td>ArrayList<E></td>
|
|
556
|
+
<td>list</td>
|
|
482
557
|
</tr>
|
|
483
|
-
|
|
484
558
|
<tr>
|
|
485
559
|
<td>Queue<E></td>
|
|
486
560
|
<td>queue<T></td>
|
|
487
561
|
<td>Queue<E></td>
|
|
488
562
|
<td>-</td>
|
|
489
563
|
</tr>
|
|
564
|
+
<tr>
|
|
565
|
+
<td>Deque<E></td>
|
|
566
|
+
<td>deque<T></td>
|
|
567
|
+
<td>-</td>
|
|
568
|
+
<td>-</td>
|
|
569
|
+
</tr>
|
|
490
570
|
<tr>
|
|
491
571
|
<td>PriorityQueue<E></td>
|
|
492
572
|
<td>priority_queue<T></td>
|
|
@@ -494,7 +574,7 @@ Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.id) // ['A', 'B', 'D
|
|
|
494
574
|
<td>-</td>
|
|
495
575
|
</tr>
|
|
496
576
|
<tr>
|
|
497
|
-
<td>Heap<
|
|
577
|
+
<td>Heap<E></td>
|
|
498
578
|
<td>priority_queue<T></td>
|
|
499
579
|
<td>PriorityQueue<E></td>
|
|
500
580
|
<td>heapq</td>
|
|
@@ -506,15 +586,21 @@ Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.id) // ['A', 'B', 'D
|
|
|
506
586
|
<td>-</td>
|
|
507
587
|
</tr>
|
|
508
588
|
<tr>
|
|
509
|
-
<td>
|
|
510
|
-
<td>
|
|
511
|
-
<td
|
|
512
|
-
<td
|
|
589
|
+
<td>Set<E></td>
|
|
590
|
+
<td>set<T></td>
|
|
591
|
+
<td>HashSet<E></td>
|
|
592
|
+
<td>set</td>
|
|
593
|
+
</tr>
|
|
594
|
+
<tr>
|
|
595
|
+
<td>Map<K, V></td>
|
|
596
|
+
<td>map<K, V></td>
|
|
597
|
+
<td>HashMap<K, V></td>
|
|
598
|
+
<td>dict</td>
|
|
513
599
|
</tr>
|
|
514
600
|
<tr>
|
|
515
|
-
<td>Trie</td>
|
|
516
|
-
<td>-</td>
|
|
517
601
|
<td>-</td>
|
|
602
|
+
<td>unordered_set<T></td>
|
|
603
|
+
<td>HashSet<E></td>
|
|
518
604
|
<td>-</td>
|
|
519
605
|
</tr>
|
|
520
606
|
<tr>
|
|
@@ -524,93 +610,99 @@ Array.from(dijkstraResult?.seen ?? []).map(vertex => vertex.id) // ['A', 'B', 'D
|
|
|
524
610
|
<td>defaultdict</td>
|
|
525
611
|
</tr>
|
|
526
612
|
<tr>
|
|
527
|
-
<td
|
|
528
|
-
<td>multiset<T></td>
|
|
613
|
+
<td>Map<K, V></td>
|
|
529
614
|
<td>-</td>
|
|
530
615
|
<td>-</td>
|
|
616
|
+
<td>OrderedDict</td>
|
|
531
617
|
</tr>
|
|
532
618
|
<tr>
|
|
619
|
+
<td>BinaryTree<K, V></td>
|
|
533
620
|
<td>-</td>
|
|
534
|
-
<td>multimap<K, V></td>
|
|
535
621
|
<td>-</td>
|
|
536
622
|
<td>-</td>
|
|
537
623
|
</tr>
|
|
538
624
|
<tr>
|
|
539
|
-
<td>
|
|
625
|
+
<td>BST<K, V></td>
|
|
540
626
|
<td>-</td>
|
|
541
627
|
<td>-</td>
|
|
542
628
|
<td>-</td>
|
|
543
629
|
</tr>
|
|
544
630
|
<tr>
|
|
545
|
-
<td>
|
|
546
|
-
<td
|
|
631
|
+
<td>TreeMultimap<K, V></td>
|
|
632
|
+
<td>multimap<K, V></td>
|
|
547
633
|
<td>-</td>
|
|
548
634
|
<td>-</td>
|
|
549
635
|
</tr>
|
|
550
636
|
<tr>
|
|
551
|
-
<td>
|
|
552
|
-
<td>-</td>
|
|
637
|
+
<td>AVLTree<E></td>
|
|
553
638
|
<td>-</td>
|
|
639
|
+
<td>TreeSet<E></td>
|
|
554
640
|
<td>-</td>
|
|
555
641
|
</tr>
|
|
556
642
|
<tr>
|
|
557
|
-
<td>
|
|
643
|
+
<td>AVLTree<K, V></td>
|
|
558
644
|
<td>-</td>
|
|
645
|
+
<td>TreeMap<K, V></td>
|
|
559
646
|
<td>-</td>
|
|
647
|
+
</tr>
|
|
648
|
+
<tr>
|
|
649
|
+
<td>AVLTree<E></td>
|
|
650
|
+
<td>set</td>
|
|
651
|
+
<td>TreeSet<E></td>
|
|
560
652
|
<td>-</td>
|
|
561
653
|
</tr>
|
|
562
654
|
<tr>
|
|
655
|
+
<td>Trie</td>
|
|
656
|
+
<td>-</td>
|
|
563
657
|
<td>-</td>
|
|
564
|
-
<td>unordered_multiset</td>
|
|
565
658
|
<td>-</td>
|
|
566
|
-
<td>Counter</td>
|
|
567
659
|
</tr>
|
|
568
660
|
<tr>
|
|
569
661
|
<td>-</td>
|
|
662
|
+
<td>multiset<T></td>
|
|
570
663
|
<td>-</td>
|
|
571
|
-
<td>LinkedHashSet<E></td>
|
|
572
664
|
<td>-</td>
|
|
573
665
|
</tr>
|
|
574
666
|
<tr>
|
|
667
|
+
<td>DirectedGraph<V, E></td>
|
|
575
668
|
<td>-</td>
|
|
576
669
|
<td>-</td>
|
|
577
|
-
<td>LinkedHashMap<K, V></td>
|
|
578
670
|
<td>-</td>
|
|
579
671
|
</tr>
|
|
580
672
|
<tr>
|
|
581
|
-
<td>
|
|
673
|
+
<td>UndirectedGraph<V, E></td>
|
|
674
|
+
<td>-</td>
|
|
582
675
|
<td>-</td>
|
|
583
|
-
<td>TreeSet<E></td>
|
|
584
676
|
<td>-</td>
|
|
585
677
|
</tr>
|
|
586
678
|
<tr>
|
|
587
|
-
<td>AVLTree<K, V></td>
|
|
588
679
|
<td>-</td>
|
|
589
|
-
<td>
|
|
680
|
+
<td>unordered_multiset</td>
|
|
590
681
|
<td>-</td>
|
|
682
|
+
<td>Counter</td>
|
|
591
683
|
</tr>
|
|
592
684
|
<tr>
|
|
593
|
-
<td
|
|
594
|
-
<td
|
|
595
|
-
<td>
|
|
685
|
+
<td>-</td>
|
|
686
|
+
<td>-</td>
|
|
687
|
+
<td>LinkedHashSet<E></td>
|
|
596
688
|
<td>-</td>
|
|
597
689
|
</tr>
|
|
598
690
|
<tr>
|
|
599
691
|
<td>-</td>
|
|
600
|
-
<td>unordered_multimap<K, V></td>
|
|
601
692
|
<td>-</td>
|
|
693
|
+
<td>LinkedHashMap<K, V></td>
|
|
602
694
|
<td>-</td>
|
|
603
695
|
</tr>
|
|
604
696
|
<tr>
|
|
605
697
|
<td>-</td>
|
|
606
|
-
<td>
|
|
698
|
+
<td>unordered_multimap<K, V></td>
|
|
607
699
|
<td>-</td>
|
|
608
700
|
<td>-</td>
|
|
609
701
|
</tr>
|
|
610
702
|
<tr>
|
|
611
703
|
<td>-</td>
|
|
612
|
-
<td>
|
|
613
|
-
<td
|
|
704
|
+
<td>bitset<N></td>
|
|
705
|
+
<td>-</td>
|
|
614
706
|
<td>-</td>
|
|
615
707
|
</tr>
|
|
616
708
|
</tbody>
|
|
@@ -627,49 +719,49 @@ Opt for concise and clear method names, avoiding excessive length while ensuring
|
|
|
627
719
|
|
|
628
720
|
### Object-oriented programming(OOP)
|
|
629
721
|
|
|
630
|
-
By strictly adhering to object-oriented design (BinaryTree -> BST -> AVLTree ->
|
|
722
|
+
By strictly adhering to object-oriented design (BinaryTree -> BST -> AVLTree -> TreeMultimap), you can seamlessly
|
|
631
723
|
inherit the existing data structures to implement the customized ones you need. Object-oriented design stands as the
|
|
632
724
|
optimal approach to data structure design.
|
|
633
725
|
|
|
634
726
|
## Benchmark
|
|
635
727
|
|
|
636
|
-
[//]: # (Start of Replace Section)
|
|
728
|
+
[//]: # (No deletion!!! Start of Replace Section)
|
|
637
729
|
<div class="json-to-html-collapse clearfix 0">
|
|
638
730
|
<div class='collapsible level0' ><span class='json-to-html-label'>avl-tree</span></div>
|
|
639
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 add randomly</td><td>30.
|
|
731
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 add randomly</td><td>30.52</td><td>32.76</td><td>3.28e-4</td></tr><tr><td>10,000 add & delete randomly</td><td>66.96</td><td>14.94</td><td>0.00</td></tr><tr><td>10,000 addMany</td><td>39.78</td><td>25.14</td><td>3.67e-4</td></tr><tr><td>10,000 get</td><td>27.38</td><td>36.52</td><td>0.00</td></tr></table></div>
|
|
640
732
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
641
733
|
<div class='collapsible level0' ><span class='json-to-html-label'>binary-tree</span></div>
|
|
642
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000 add randomly</td><td>
|
|
734
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000 add randomly</td><td>10.50</td><td>95.20</td><td>2.30e-4</td></tr><tr><td>1,000 add & delete randomly</td><td>16.18</td><td>61.81</td><td>2.48e-4</td></tr><tr><td>1,000 addMany</td><td>10.80</td><td>92.62</td><td>1.83e-4</td></tr><tr><td>1,000 get</td><td>18.03</td><td>55.45</td><td>1.41e-4</td></tr><tr><td>1,000 dfs</td><td>157.86</td><td>6.33</td><td>0.00</td></tr><tr><td>1,000 bfs</td><td>56.68</td><td>17.64</td><td>0.00</td></tr><tr><td>1,000 morris</td><td>37.21</td><td>26.88</td><td>2.79e-4</td></tr></table></div>
|
|
643
735
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
644
736
|
<div class='collapsible level0' ><span class='json-to-html-label'>bst</span></div>
|
|
645
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 add randomly</td><td>
|
|
737
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 add randomly</td><td>27.61</td><td>36.21</td><td>4.73e-4</td></tr><tr><td>10,000 add & delete randomly</td><td>62.93</td><td>15.89</td><td>5.86e-4</td></tr><tr><td>10,000 addMany</td><td>28.70</td><td>34.84</td><td>0.00</td></tr><tr><td>10,000 get</td><td>27.67</td><td>36.14</td><td>2.92e-4</td></tr></table></div>
|
|
646
738
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
647
739
|
<div class='collapsible level0' ><span class='json-to-html-label'>rb-tree</span></div>
|
|
648
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>100,000 add randomly</td><td>
|
|
740
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>100,000 add randomly</td><td>87.51</td><td>11.43</td><td>0.01</td></tr><tr><td>100,000 add & delete randomly</td><td>189.06</td><td>5.29</td><td>0.01</td></tr><tr><td>100,000 getNode</td><td>35.33</td><td>28.31</td><td>8.93e-4</td></tr></table></div>
|
|
649
741
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
650
742
|
<div class='collapsible level0' ><span class='json-to-html-label'>directed-graph</span></div>
|
|
651
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000 addVertex</td><td>0.10</td><td>
|
|
743
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000 addVertex</td><td>0.10</td><td>9899.91</td><td>8.58e-7</td></tr><tr><td>1,000 addEdge</td><td>6.06</td><td>165.02</td><td>1.68e-4</td></tr><tr><td>1,000 getVertex</td><td>0.05</td><td>2.17e+4</td><td>4.22e-7</td></tr><tr><td>1,000 getEdge</td><td>23.05</td><td>43.38</td><td>0.00</td></tr><tr><td>tarjan</td><td>222.59</td><td>4.49</td><td>0.01</td></tr><tr><td>tarjan all</td><td>226.89</td><td>4.41</td><td>0.01</td></tr><tr><td>topologicalSort</td><td>187.34</td><td>5.34</td><td>0.01</td></tr></table></div>
|
|
652
744
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
653
745
|
<div class='collapsible level0' ><span class='json-to-html-label'>heap</span></div>
|
|
654
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 add & pop</td><td>4.
|
|
746
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 add & pop</td><td>4.66</td><td>214.54</td><td>9.38e-5</td></tr><tr><td>10,000 fib add & pop</td><td>364.30</td><td>2.74</td><td>0.01</td></tr></table></div>
|
|
655
747
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
656
748
|
<div class='collapsible level0' ><span class='json-to-html-label'>doubly-linked-list</span></div>
|
|
657
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000,000 unshift</td><td>
|
|
749
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000,000 unshift</td><td>243.61</td><td>4.10</td><td>0.07</td></tr><tr><td>1,000,000 unshift & shift</td><td>173.32</td><td>5.77</td><td>0.03</td></tr><tr><td>1,000,000 insertBefore</td><td>315.86</td><td>3.17</td><td>0.04</td></tr></table></div>
|
|
658
750
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
659
751
|
<div class='collapsible level0' ><span class='json-to-html-label'>singly-linked-list</span></div>
|
|
660
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 push & pop</td><td>
|
|
752
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 push & pop</td><td>228.06</td><td>4.38</td><td>0.03</td></tr><tr><td>10,000 insertBefore</td><td>252.07</td><td>3.97</td><td>0.01</td></tr></table></div>
|
|
661
753
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
662
754
|
<div class='collapsible level0' ><span class='json-to-html-label'>max-priority-queue</span></div>
|
|
663
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 refill & poll</td><td>11.
|
|
755
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>10,000 refill & poll</td><td>11.53</td><td>86.71</td><td>2.27e-4</td></tr></table></div>
|
|
664
756
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
665
757
|
<div class='collapsible level0' ><span class='json-to-html-label'>deque</span></div>
|
|
666
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000,000 push</td><td>
|
|
758
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000,000 push</td><td>227.24</td><td>4.40</td><td>0.07</td></tr><tr><td>1,000,000 shift</td><td>25.60</td><td>39.07</td><td>0.00</td></tr></table></div>
|
|
667
759
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
668
760
|
<div class='collapsible level0' ><span class='json-to-html-label'>queue</span></div>
|
|
669
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000,000 push</td><td>
|
|
761
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>1,000,000 push</td><td>45.98</td><td>21.75</td><td>0.01</td></tr><tr><td>1,000,000 push & shift</td><td>81.12</td><td>12.33</td><td>0.00</td></tr></table></div>
|
|
670
762
|
</div><div class="json-to-html-collapse clearfix 0">
|
|
671
763
|
<div class='collapsible level0' ><span class='json-to-html-label'>trie</span></div>
|
|
672
|
-
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>100,000 push</td><td>
|
|
764
|
+
<div class="content"><table style="display: table; width:100%; table-layout: fixed;"><tr><th>test name</th><th>time taken (ms)</th><th>executions per sec</th><th>sample deviation</th></tr><tr><td>100,000 push</td><td>59.40</td><td>16.83</td><td>0.01</td></tr><tr><td>100,000 getWords</td><td>90.07</td><td>11.10</td><td>0.00</td></tr></table></div>
|
|
673
765
|
</div>
|
|
674
766
|
|
|
675
|
-
[//]: # (End of Replace Section)
|
|
767
|
+
[//]: # (No deletion!!! End of Replace Section)
|