[Deprecated] A tiny functional data structure for pairs of arbitrary values
npm install @danielnarey/pair[Deprecated] A tiny functional data structure for pairs of arbitrary values
> Deprecation Warning: This experimental library is no longer in active development and will not be updated in response to Node.js version releases or security vulnerabilities identified in the dependency tree.
When you have two values that you want to join with the same reference or return from a function, using a pair gives you immutability, along with a clean functional pattern for updating one or both values to a new reference.
``js
import pair from '@danielnarey/pair';
// OR: const pair = require('@danielnarey/pair');
// constructor
const p = pair.of('🍐', 42);
typeof(p); //--> 'function'
// accessors
pair.first(p); //--> '🍐'
pair.second(p); //--> 42
// conversion
pair.toArray(p); //--> ['🍐', 42]
pair.toString(p); //--> '(🍐 . 42)'
// functional transforms
const q = pair.mapFirst(p, (s) => ${s}🍎);
const r = pair.mapSecond(q, (n) => n + 1);
// immutability
pair.toString(p); //--> '(🍐 . 42)'
pair.toString(q); //--> '(🍐🍎 . 42)'
pair.toString(r); //--> '(🍐🍎 . 43)'
`
).$3
Take the first two values of an array (or other iterable) and join them as a pair.$3
Returns the first value of a pair.$3
Returns the second value of a pair.$3
Apply a function to the first value of a pair, returning an interface to the new pair.$3
Apply a function to the second value of a pair.$3
Apply a function to the each value of a pair.$3
Apply a single function to both values of a pair.$3
Reduce (fold) a pair from the left and return the result. The reducer should be a function of the form (accumulator, current) => intermediate. If specified, the initial value is the value of accumulator on the first pass. If not specified, the reducer executes only once with the first and second values of the pair as its arguments.$3
Reduce (fold) a pair from the right and return the result. Equivalent to reduce` with the order of the pair reversed.