curry-function
v1.0.3
Published
Curry-function. Similar to 'curry', but does not use dangerous eval. Lightweight and minimal. Passed a function f, returns the curried variant of f. Handles arbitrary number of arguments and supports overloading.
Downloads
8
Maintainers
Readme
🍛 Curry-function
Curry-function. Passed a function f, returns a curried variant of f. Lightweight and minimal. Handles arbitrary number of arguments and supports overloading. Similar to curry, but does not use dangerous eval.
Usage
Install locally with npm:
npm i curry-function
Import:
const curry = require('curry-function');
or
import curry from 'curry-function';
API
Syntax
curry(func);
Parameters
func
Required. The function to be curried.
Return
A new function. The curried variant of the argument function.
Example:
const curry = require('curry-function');
const sum = (x, y, z) => x + y + z;
const curriedSum = curry(sum);
const applyFirst = curriedSum(1); // returns function
const applySecond = applyFirst(2); // returns function
const applyAll = applySecond(3); // returns 6
Overloading:
curriedSum(1, 2);
// returns function, is equivalent to:
curriedSum(1)(2);
// argument function can be called as usual:
curriedSum(1, 2, 3);
// returns 6, is equivalent to:
curriedSum(1)(2)(3);
// is equivalent to:
sum(1, 2, 3)
Test
Tested with AVA.
npm test
or
npx ava
Currying
Given a function f with n parameters, curry returns n functions, each taking exactly one of f's parameters, one parameter by one. The final function executes f's code. For an overview on the uses of currying see this article.
To illustrate:
// not curried expression
const notCurried = function(x, y, z) {
return z + y + z;
}
// curried expression
const curried = function(x) {
return function(y) {
return function(z) {
return x + y + z;
}
}
};
// not curried arrow
const notCurried = (x, y, z) => x + y + z;
// curried arrow
const curried = (x) => (y) => (z) => x + y + z;