Travis build: 1211

README.md

@@ -272,6 +272,7 @@ average(1, 2, 3);
 * [`select`](#select)
 * [`shallowClone`](#shallowclone)
 * [`size`](#size)
+* [`transform`](#transform)
 * [`truthCheckCollection`](#truthcheckcollection)
 
 </details>
@@ -4230,6 +4231,35 @@ size({ one: 1, two: 2, three: 3 }); // 3
 <br>[⬆ Back to top](#table-of-contents)
 
 
+### transform
+
+Applies a function against an accumulator and each key in the object (from left to right).
+
+Use `Object.keys(obj)` to iterate over each key in the object, `Array.reduce()` to call the apply the specified function against the given accumulator.
+
+```js
+const transform = (obj, fn, acc) => Object.keys(obj).reduce((a, k) => fn(a, obj[k], k, obj), acc);
+```
+
+<details>
+<summary>Examples</summary>
+
+```js
+transform(
+  { a: 1, b: 2, c: 1 },
+  (r, v, k) => {
+    (r[v] || (r[v] = [])).push(k);
+    return r;
+  },
+  {}
+); // { '1': ['a', 'c'], '2': ['b'] }
+```
+
+</details>
+
+<br>[⬆ Back to top](#table-of-contents)
+
+
 ### truthCheckCollection
 
 Checks if the predicate (second argument) is truthy on all elements of a collection (first argument).

snippets/transform.md

@@ -5,13 +5,16 @@ Applies a function against an accumulator and each key in the object (from left
 Use `Object.keys(obj)` to iterate over each key in the object, `Array.reduce()` to call the apply the specified function against the given accumulator.
 
 ```js
-const transform = (obj, fn, acc) =>
+const transform = (obj, fn, acc) => Object.keys(obj).reduce((a, k) => fn(a, obj[k], k, obj), acc);
-  Object.keys(obj).reduce((a, k) => fn(a, obj[k], k, obj), acc);
 ```
 
 ```js
-transform({ 'a': 1, 'b': 2, 'c': 1 }, (r, v, k) => {
+transform(
+  { a: 1, b: 2, c: 1 },
+  (r, v, k) => {
     (r[v] || (r[v] = [])).push(k);
     return r;
-}, {}); // { '1': ['a', 'c'], '2': ['b'] }
+  },
+  {}
+); // { '1': ['a', 'c'], '2': ['b'] }
 ```