English | 简体中文
- Vector
- Stack
- Queue
- LinkList
- Deque
- PriorityQueue
- OrderedSet (using RBTree)
- OrderedMap (using RBTree)
- HashSet
- HashMap
We are benchmarking against other popular data structure libraries. In some ways we're better than the best library. See benchmark.
- node.js (using commonjs)
- react/vue (using es5)
- browser (support most browsers)
Download directly
- js-sdsl.js (for development)
- js-sdsl.min.js (for production)
Or install js-sdsl using npm
npm install js-sdsl
You can visit our official website to get more information.
To help you have a better use, we also provide this API document.
<!-- you can download the file locally and import it or import it dynamically by using url. -->
<script src="https://unpkg.com/js-sdsl/dist/umd/js-sdsl.min.js"></script>
<script>
const {
Vector,
Stack,
Queue,
LinkList,
Deque,
PriorityQueue,
OrderedSet,
OrderedMap,
HashSet,
HashMap
} = sdsl;
const myOrderedMap = new OrderedMap();
myOrderedMap.setElement(1, 2);
console.log(myOrderedMap.getElementByKey(1)); // 2
</script>
// esModule
import { OrderedMap } from 'js-sdsl';
// commonJs
const { OrderedMap } = require('js-sdsl');
const myOrderedMap = new OrderedMap();
myOrderedMap.setElement(1, 2);
console.log(myOrderedMap.getElementByKey(1)); // 2
You can pull this repository and run yarn build
to rebuild this library.
We use jest library to write unit tests, you can see test coverage on coveralls. You can run yarn test:unit
command to reproduce it.
We tested most of the functions for efficiency. You can go to testResult.txt
to see our running results or reproduce it with yarn test:performance
command.
The following is a partial interception of the performance test:
=================================== OrderedSet ===================================
┌─────────┬─────────────────────┬─────────┬───────────────┬─────────┐
│ (index) │ testFunc │ testNum │ containerSize │ runTime │
├─────────┼─────────────────────┼─────────┼───────────────┼─────────┤
│ 0 │ 'constructor' │ 1 │ 1000000 │ 1667 │
│ 1 │ 'insert' │ 1000000 │ 2000000 │ 558 │
│ 2 │ 'eraseElementByKey' │ 1000000 │ 3000000 │ 362 │
│ 3 │ 'eraseElementByPos' │ 10 │ 3000000 │ 633 │
│ 4 │ 'union' │ 1 │ 2999998 │ 1949 │
│ 5 │ 'lowerBound' │ 1000000 │ 2999998 │ 1665 │
│ 6 │ 'upperBound' │ 1000000 │ 2999998 │ 1722 │
│ 7 │ 'reverseLowerBound' │ 1000000 │ 2999998 │ 1690 │
│ 8 │ 'reverseUpperBound' │ 1000000 │ 2999998 │ 1713 │
└─────────┴─────────────────────┴─────────┴───────────────┴─────────┘
=================================== OrderedMap ===================================
┌─────────┬─────────────────────┬─────────┬───────────────┬─────────┐
│ (index) │ testFunc │ testNum │ containerSize │ runTime │
├─────────┼─────────────────────┼─────────┼───────────────┼─────────┤
│ 0 │ 'constructor' │ 1 │ 1000000 │ 1574 │
│ 1 │ 'setElement' │ 1000000 │ 2000000 │ 643 │
│ 2 │ 'eraseElementByKey' │ 1000000 │ 2000000 │ 344 │
│ 3 │ 'eraseElementByPos' │ 100 │ 1000000 │ 6082 │
│ 4 │ 'union' │ 1 │ 1999900 │ 1888 │
│ 5 │ 'lowerBound' │ 1000000 │ 1999900 │ 1615 │
│ 6 │ 'upperBound' │ 1000000 │ 1999900 │ 1666 │
│ 7 │ 'reverseLowerBound' │ 1000000 │ 1999900 │ 1619 │
│ 8 │ 'reverseUpperBound' │ 1000000 │ 1999900 │ 1665 │
└─────────┴─────────────────────┴─────────┴───────────────┴─────────┘
Feel free to dive in! Open an issue or submit PRs. It may be helpful to read the Contributor Guide.
Thanks goes to these wonderful people:
Takatoshi Kondo 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!
MIT © ZLY201