docs: adds replaceAll example

2 files changed, 23 insertions, 0 deletions

diff --git a/README.md b/README.md
index f6e4054..eb2c9ee 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,9 @@ Whitespaces are ignored (except within literals)
 
 ### Examples
 
+
+#### matchAll
+
 ```js
 // | Match for any number or any non-empty string or any object with `prop` is true
 matchAll(/ \n | \s\T /, [null, 23, '', 'wow', false ]
@@ -81,3 +84,14 @@ matchAll(/ [seperator true], [id \s\T]+ /, [
 // }
 ```
 
+
+#### replaceAll
+
+```js
+// | Match for any number or any non-empty string or any object with `prop` is true
+const replacer = (_, matches) => matches.value.reduce((a, b) => a + b, 0)
+replaceAll(/ \n+ /, replacer, [ 'start', 3, 5, 'mid', 2, 0, 4, 'end' ])
+
+// > [ 'start', 8, 'mid', 6, 'end' ]
+```
+
diff --git a/tests/replace.spec.ts b/tests/replace.spec.ts
index dd82eaa..98f1540 100644
--- a/tests/replace.spec.ts
+++ b/tests/replace.spec.ts
@@ -3,6 +3,15 @@ import { replaceAll } from '../src'
 
 describe('Basic tests', () => {
   it('should', () => {
+    const replacer = (_, matches) => [matches.value.reduce((a, b) => a + b, 0)]
+    expect(replaceAll(/ \n+ /, replacer, ['start', 3, 5, 'mid', 2, 0, 4, 'end'])).toEqual([
+      'start',
+      8,
+      'mid',
+      6,
+      'end',
+    ])
+
     expect(
       replaceAll(/"start", \s, \n/, _ => ['replaced'], [
         1,