some :: (Function predicate, Collection collection) => Boolean|Promise<Boolean> output
description
Returns a Boolean indicating if at least one item in the input collection satisfies the provided predicate function. It works exactly like , except it also accepts Sets, Maps & Objects as inputs, and asynchronous predicates.
Like all functions in conductor, this function is automatically is curried. If the predicate is asynchronous, it will return a Promise, allowing you to use Promise.prototype.then or the await keyword to retrieve the result.
examples
basic example
import { some } from 'conductor'
const numbers = [3, 1, 4]
const isEven = number => number % 2 === 0
some(isEven, numbers) // true
Here, we simply check if at least one item in our numbers array is an even number. Luckily, that's the case.
using other data structures
import { some } from 'conductor'
const object = { three: 3, one: 1, four: 4}
const set = new Set([3, 1, 4])
const map = new Map([['three', 3], ['one', 1], ['four', 4]])
const isEven = number => number % 2 === 0
some(isEven, object) // true
some(isEven, set) // true
some(isEven, map) // true
some also works on Objects, Sets, and Maps.
using an asynchronous predicate
import { some } from 'conductor'
const numbers = [3, 1, 4]
const isEvenAsync = async number => number % 2 === 0
await some(isEvenAsync, numbers) // true
Here, our predicate is asynchronous (notice the async keyword before the function definition), which makes some return a Promise. We then (no pun intended) simply use the await keyword to retrieve the result.
