test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
100,000 add | 6.42 | 155.78 | 1.88e-4 |
100,000 add & poll | 31.60 | 31.65 | 9.13e-4 |
# data-structure-typed ![npm](https://img.shields.io/npm/dm/data-structure-typed) ![GitHub contributors](https://img.shields.io/github/contributors/zrwusa/data-structure-typed) ![npm package minimized gzipped size (select exports)](https://img.shields.io/bundlejs/size/data-structure-typed) ![GitHub top language](https://img.shields.io/github/languages/top/zrwusa/data-structure-typed) ![GITHUB Star](https://img.shields.io/github/stars/zrwusa/data-structure-typed) ![eslint](https://aleen42.github.io/badges/src/eslint.svg) ![NPM](https://img.shields.io/npm/l/data-structure-typed) ![npm](https://img.shields.io/npm/v/data-structure-typed) [//]: # (![npm bundle size](https://img.shields.io/bundlephobia/min/data-structure-typed)) [//]: # (
) ## Installation and Usage ### npm ```bash npm i data-structure-typed --save ``` ### yarn ```bash yarn add data-structure-typed ``` ```js import { Heap, Graph, Queue, Deque, PriorityQueue, BST, Trie, DoublyLinkedList, AVLTree, SinglyLinkedList, DirectedGraph, RedBlackTree, TreeMultiMap, DirectedVertex, Stack, AVLTreeNode } from 'data-structure-typed'; ``` If you only want to use a specific data structure independently, you can install it separately, for example, by running ```bash npm i heap-typed --save ``` ## Why Do you envy C++ with [STL]() (std::), Python with [collections](), and Java with [java.util]() ? Well, no need to envy anymore! JavaScript and TypeScript now have [data-structure-typed]().**`Benchmark`** compared with C++ STL. **`API standards`** aligned with ES6 and Java. **`Usability`** is comparable to Python [//]: # (![Branches](https://img.shields.io/badge/branches-55.47%25-red.svg?style=flat)) [//]: # (![Statements](https://img.shields.io/badge/statements-67%25-red.svg?style=flat)) [//]: # (![Functions](https://img.shields.io/badge/functions-66.38%25-red.svg?style=flat)) [//]: # (![Lines](https://img.shields.io/badge/lines-68.6%25-red.svg?style=flat)) ### Performance Performance surpasses that of native JS/TSMethod | Time Taken | Data Scale | Belongs To | big O |
---|---|---|---|---|
Queue.push & shift | 5.83 ms | 100K | Ours | O(1) |
Array.push & shift | 2829.59 ms | 100K | Native JS | O(n) |
Deque.unshift & shift | 2.44 ms | 100K | Ours | O(1) |
Array.unshift & shift | 4750.37 ms | 100K | Native JS | O(n) |
HashMap.set | 122.51 ms | 1M | Ours | O(1) |
Map.set | 223.80 ms | 1M | Native JS | O(1) |
Set.add | 185.06 ms | 1M | Native JS | O(1) |
Java ArrayList | Java Queue | Java ArrayDeque | Java LinkedList |
---|---|---|---|
add | offer | push | push |
remove | poll | removeLast | removeLast |
remove | poll | removeFirst | removeFirst |
add(0, element) | offerFirst | unshift | unshift |
Data Structure | Unit Test | Perf Test | API Doc | NPM | Downloads |
---|---|---|---|---|---|
Binary Tree | View | View | |||
Binary Search Tree (BST) | View | View | |||
AVL Tree | View | View | |||
Red Black Tree | View | View | |||
Tree Multimap | View | View | |||
Heap | View | View | |||
Priority Queue | View | View | |||
Max Priority Queue | View | View | |||
Min Priority Queue | View | View | |||
Trie | View | View | |||
Graph | View | View | |||
Directed Graph | View | View | |||
Undirected Graph | View | View | |||
Queue | View | View | |||
Deque | View | View | |||
Hash Map | View | ||||
Linked List | View | View | |||
Singly Linked List | View | View | |||
Doubly Linked List | View | View | |||
Stack | View | View | |||
Segment Tree | View | ||||
Binary Indexed Tree | View |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
100,000 add | 6.42 | 155.78 | 1.88e-4 |
100,000 add & poll | 31.60 | 31.65 | 9.13e-4 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
100,000 add | 59.28 | 16.87 | 7.81e-4 |
100,000 add randomly | 71.61 | 13.96 | 9.02e-4 |
100,000 get | 104.13 | 9.60 | 0.00 |
100,000 iterator | 27.03 | 37.00 | 0.00 |
100,000 add & delete orderly | 126.42 | 7.91 | 0.00 |
100,000 add & delete randomly | 214.36 | 4.66 | 0.00 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000,000 push | 44.98 | 22.23 | 0.01 |
100,000 push & shift | 4.89 | 204.39 | 6.15e-4 |
Native JS Array 100,000 push & shift | 2251.13 | 0.44 | 0.26 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000,000 push | 22.21 | 45.02 | 0.00 |
1,000,000 push & pop | 30.97 | 32.29 | 0.00 |
1,000,000 push & shift | 30.81 | 32.46 | 0.00 |
100,000 push & shift | 3.24 | 308.25 | 2.08e-4 |
Native JS Array 100,000 push & shift | 2279.95 | 0.44 | 0.21 |
100,000 unshift & shift | 2.93 | 341.78 | 3.21e-4 |
Native JS Array 100,000 unshift & shift | 4076.04 | 0.25 | 0.42 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000,000 set | 118.11 | 8.47 | 0.02 |
Native JS Map 1,000,000 set | 206.18 | 4.85 | 0.01 |
Native JS Set 1,000,000 add | 167.50 | 5.97 | 0.01 |
1,000,000 set & get | 116.15 | 8.61 | 0.01 |
Native JS Map 1,000,000 set & get | 269.11 | 3.72 | 0.02 |
Native JS Set 1,000,000 add & has | 168.02 | 5.95 | 0.01 |
1,000,000 ObjKey set & get | 335.36 | 2.98 | 0.04 |
Native JS Map 1,000,000 ObjKey set & get | 327.78 | 3.05 | 0.06 |
Native JS Set 1,000,000 ObjKey add & has | 281.64 | 3.55 | 0.04 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
100,000 push | 43.64 | 22.91 | 8.01e-4 |
100,000 getWords | 82.95 | 12.06 | 0.00 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
100,000 add | 263.01 | 3.80 | 0.02 |
100,000 add randomly | 353.89 | 2.83 | 0.01 |
100,000 get | 131.65 | 7.60 | 0.00 |
100,000 iterator | 31.62 | 31.63 | 0.01 |
100,000 add & delete orderly | 468.81 | 2.13 | 0.00 |
100,000 add & delete randomly | 628.30 | 1.59 | 0.03 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
10,000 RBTree add randomly | 5.79 | 172.73 | 7.35e-5 |
10,000 RBTree get randomly | 9.58 | 104.37 | 9.96e-5 |
10,000 RBTree add & delete randomly | 17.82 | 56.12 | 1.90e-4 |
10,000 AVLTree add randomly | 27.85 | 35.91 | 3.16e-4 |
10,000 AVLTree get randomly | 10.73 | 93.19 | 6.38e-5 |
10,000 AVLTree add & delete randomly | 48.98 | 20.42 | 3.91e-4 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000 addVertex | 0.10 | 9624.60 | 7.61e-7 |
1,000 addEdge | 6.02 | 166.18 | 1.45e-4 |
1,000 getVertex | 0.05 | 2.17e+4 | 3.52e-7 |
1,000 getEdge | 23.88 | 41.88 | 0.00 |
tarjan | 215.08 | 4.65 | 0.01 |
topologicalSort | 187.83 | 5.32 | 0.00 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000,000 push | 221.69 | 4.51 | 0.03 |
1,000,000 unshift | 227.33 | 4.40 | 0.07 |
1,000,000 unshift & shift | 170.08 | 5.88 | 0.02 |
1,000,000 addBefore | 321.29 | 3.11 | 0.07 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000,000 push & shift | 213.14 | 4.69 | 0.04 |
10,000 push & pop | 217.84 | 4.59 | 0.01 |
10,000 addBefore | 250.81 | 3.99 | 0.01 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
100,000 add | 26.91 | 37.16 | 1.96e-4 |
100,000 add & poll | 75.09 | 13.32 | 5.04e-4 |
test name | time taken (ms) | executions per sec | sample deviation |
---|---|---|---|
1,000,000 push | 39.92 | 25.05 | 0.01 |
1,000,000 push & pop | 48.08 | 20.80 | 0.01 |
Data Structure Typed | C++ STL | java.util | Python collections |
---|---|---|---|
Heap<E> | - | - | heapq |
PriorityQueue<E> | priority_queue<T> | PriorityQueue<E> | - |
Deque<E> | deque<T> | ArrayDeque<E> | deque |
Queue<E> | queue<T> | Queue<E> | - |
HashMap<K, V> | unordered_map<K, V> | HashMap<K, V> | defaultdict |
DoublyLinkedList<E> | list<T> | LinkedList<E> | - |
SinglyLinkedList<E> | - | - | - |
BinaryTree<K, V> | - | - | - |
BST<K, V> | - | - | - |
RedBlackTree<E> | set<T> | TreeSet<E> | - |
RedBlackTree<K, V> | map<K, V> | TreeMap<K, V> | - |
TreeMultiMap<K, V> | multimap<K, V> | - | - |
TreeMultiMap<E> | multiset<T> | - | - |
Trie | - | - | - |
DirectedGraph<V, E> | - | - | - |
UndirectedGraph<V, E> | - | - | - |
PriorityQueue<E> | priority_queue<T> | PriorityQueue<E> | - |
Array<E> | vector<T> | ArrayList<E> | list |
Stack<E> | stack<T> | Stack<E> | - |
HashMap<E> | unordered_set<T> | HashSet<E> | set |
- | unordered_multiset | - | Counter |
LinkedHashMap<K, V> | - | LinkedHashMap<K, V> | OrderedDict |
- | unordered_multimap<K, V> | - | - |
- | bitset<N> | - | - |
Algorithm | Function Description | Iteration Type |
---|---|---|
Binary Tree DFS | Traverse a binary tree in a depth-first manner, starting from the root node, first visiting the left subtree, and then the right subtree, using recursion. | Recursion + Iteration |
Binary Tree BFS | Traverse a binary tree in a breadth-first manner, starting from the root node, visiting nodes level by level from left to right. | Iteration |
Graph DFS | Traverse a graph in a depth-first manner, starting from a given node, exploring along one path as deeply as possible, and backtracking to explore other paths. Used for finding connected components, paths, etc. | Recursion + Iteration |
Binary Tree Morris | Morris traversal is an in-order traversal algorithm for binary trees with O(1) space complexity. It allows tree traversal without additional stack or recursion. | Iteration |
Graph BFS | Traverse a graph in a breadth-first manner, starting from a given node, first visiting nodes directly connected to the starting node, and then expanding level by level. Used for finding shortest paths, etc. | Recursion + Iteration |
Graph Tarjan's Algorithm | Find strongly connected components in a graph, typically implemented using depth-first search. | Recursion |
Graph Bellman-Ford Algorithm | Finding the shortest paths from a single source, can handle negative weight edges | Iteration |
Graph Dijkstra's Algorithm | Finding the shortest paths from a single source, cannot handle negative weight edges | Iteration |
Graph Floyd-Warshall Algorithm | Finding the shortest paths between all pairs of nodes | Iteration |
Graph getCycles | Find all cycles in a graph or detect the presence of cycles. | Recursion |
Graph getCutVertices | Find cut vertices in a graph, which are nodes that, when removed, increase the number of connected components in the graph. | Recursion |
Graph getSCCs | Find strongly connected components in a graph, which are subgraphs where any two nodes can reach each other. | Recursion |
Graph getBridges | Find bridges in a graph, which are edges that, when removed, increase the number of connected components in the graph. | Recursion |
Graph topologicalSort | Perform topological sorting on a directed acyclic graph (DAG) to find a linear order of nodes such that all directed edges go from earlier nodes to later nodes. | Recursion |
Principle | Description |
---|---|
Practicality | Follows ES6 and ESNext standards, offering unified and considerate optional parameters, and simplifies method names. |
Extensibility | Adheres to OOP (Object-Oriented Programming) principles, allowing inheritance for all data structures. |
Modularization | Includes data structure modularization and independent NPM packages. |
Efficiency | All methods provide time and space complexity, comparable to native JS performance. |
Maintainability | Follows open-source community development standards, complete documentation, continuous integration, and adheres to TDD (Test-Driven Development) patterns. |
Testability | Automated and customized unit testing, performance testing, and integration testing. |
Portability | Plans for porting to Java, Python, and C++, currently achieved to 80%. |
Reusability | Fully decoupled, minimized side effects, and adheres to OOP. |
Security | Carefully designed security for member variables and methods. Read-write separation. Data structure software does not need to consider other security aspects. |
Scalability | Data structure software does not involve load issues. |