# ranges-push
> Gather string index ranges
## Install
```bash
npm i ranges-push
```
## Quick Take
```js
import { strict as assert } from "assert";
import { Ranges } from "ranges-push";
import { rApply } from "ranges-apply";
const gatheredRanges = new Ranges();
const oldString = `The quick brown fox jumps over the lazy dog.`;
// push the ranges
gatheredRanges.push(35, 43, "little Red Riding Hood");
gatheredRanges.push(4, 19, "bad grey wolf");
// retrieve the merged and sorted ranges by calling .current()
assert.deepEqual(gatheredRanges.current(), [
[4, 19, "bad grey wolf"],
[35, 43, "little Red Riding Hood"],
]);
assert.equal(
rApply(oldString, gatheredRanges.current()),
"The bad grey wolf jumps over the little Red Riding Hood."
);
// wipe all gathered ranges
gatheredRanges.wipe();
assert.equal(gatheredRanges.current(), null);
```
## Documentation
Please [visit codsen.com](https://codsen.com/os/ranges-push/) for a full description of the API and examples.
## Contributing
To report bugs or request features or assistance, [raise an issue](https://github.com/codsen/codsen/issues/new/choose) on GitHub.
## Licence
MIT License
Copyright (c) 2010-2021 Roy Revelt and other contributors
