curry-d

Curry and curry right at arbitrary depth, then uncurry, if you want.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
curry-d
620.6.011 years ago11 years agoMinified + gzip package size for curry-d in KB

Readme

curry-d
An efficient implementation of curry. Using a dispatcher, gets a little more than 20% speed increase over traditional approach while still adding lots of sugar.1

Usage

This module exports three functions: curry, curryRight, and uncurry.

curry

curry fills a functions signature from left to right until all args are defined:
var add = function (a, b) {
    return a + b;
};

// add.length === 2, so it must be given two args.
var curried = curry(add)(40); // a function
curried(2); // 42
In case you need to curry a varargs function you can specify the number of arguments desired at curry time:
var add = function () {
    return require('lodash').reduce(arguments, function (total, n) {return total + n;});
};

var curried = curry(add)(40); // undefined
var curried = curry(add, 2)(40); // a function
curried(2); // 42
You can optionally add multiple arguments in each call:
curry(add, 2)(40, 2); // 42
Unless you want to force a single argument per call (handy w/ e.g., .forEach):
curry(add, 2, true)(40, 99)(2); // 42
However, you cannot overflow your arguments:
curry(add, 2)(40, 2, 99); // 42
Unless you really want to:
curry(add, null, null, false)(40, 2, 99); // 141

curryRight

curryRight works just like curry, but in the opposite direction:
var divide = function (a, b) {
    return a / b;
};

curry(divide)(1, 2); // .5

curryRight(divide)(1, 2); // 2

uncurry

uncurry takes a curried function and returns the original. Handy if you've curried something but need the original too. Or if you're unsure if something is curried, uncurry is a noop if the function is not curried:
uncurry(curry(divide)(1)) === divide; // true
More to come.