find

README.md

@@ -9,7 +9,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/tinyfunk"><img src="https://img.shields.io/npm/v/tinyfunk.svg" alt="npm version" style="max-width:100%;"></a>
   <a href="https://www.npmjs.com/package/tinyfunk"><img src="https://img.shields.io/npm/dm/tinyfunk.svg" alt="npm downloads" style="max-width:100%;"></a>
-  <a href="#"><img src="https://img.shields.io/badge/gzip--size-1.43%20kB-blue.svg" alt="gzip-size" style="max-width:100%;"></a>
+  <a href="#"><img src="https://img.shields.io/badge/gzip--size-1.44%20kB-blue.svg" alt="gzip-size" style="max-width:100%;"></a>
   <br />
   <a href="https://travis-ci.org/flintinatux/tinyfunk"><img src="https://travis-ci.org/flintinatux/tinyfunk.svg?branch=master" alt="Build Status" style="max-width:100%;"></a>
   <a href="https://coveralls.io/github/flintinatux/tinyfunk?branch=master"><img src="https://coveralls.io/repos/github/flintinatux/tinyfunk/badge.svg?branch=master" alt="Coverage Status" style="max-width:100%;"></a>
@@ -89,6 +89,7 @@ If you've lived with FP long enough, you are likely familiar with most of the fu
 | `dissocPath` | `[k] -> { k: v } -> { k: v }` |
 | `evolve` | `{ k: (v -> v) } -> { k: v } -> { k: v }` |
 | `filter` | `(a -> Boolean) -> [a] -> [a]` |
+| `find` | `(a -> Boolean) -> [a] -> a` |
 | `flip` | `(a -> b -> c) -> (b -> a -> c)` |
 | `head` | `[a] -> a` |
 | `identity` | `a -> a` |

src.js

@@ -125,6 +125,11 @@ const filter = curry((pred, list) =>
   list.filter(pred)
 )
 
+// find :: (a -> Boolean) -> [a] -> a
+const find = curry((pred, list) =>
+  list.find(pred)
+)
+
 // flip :: (a -> b -> c) -> (b -> a -> c)
 const flip = curry((f, x, y) =>
   curry(f)(y, x)
@@ -394,6 +399,7 @@ _assign(exports, {
   dissocPath,
   evolve,
   filter,
+  find,
   flip,
   head,
   identity,

test/find.js

@@ -0,0 +1,18 @@
+const { expect } = require('chai')
+
+const { find } = require('..')
+
+describe('find', () => {
+  const arr = [1, 2, 3, 4]
+
+  const gt2 = x =>
+    x > 2
+
+  it('finds an item in a list', () =>
+    expect(find(gt2, arr)).to.equal(3)
+  )
+
+  it('is curried', () =>
+    expect(find(gt2)(arr)).to.equal(3)
+  )
+})