Function.uCurry()

Overview

Create a new function based on an existing function but with some parameters pre-defined.

For more info on currying, see Wikipedia.

Availability

Util.js v0.5 and above.

Syntax

var fNew = fExisting.uCurry(cArgs);
 
fNew(args);

Where fExisting is any existing function.

Parameters

Parameter	Type	Mandatory	Description	Util.js version
cArgs	One or more arguments		One or more arguments that will be passed in to fExisting when you access it via fNew	0.5

Return value

Value	Type	Description	Util.js version
<fNew>	Function	A new function which will automatically set the cArgs arguments for fExisting and then append any additional arguments passed in to fNew.	0.5
<fExisting>	Function	If you do not specify cArgs then the existing function will be returned.	0.5

Example

function booler(not,a,b) {
  return (not) ? a!=b : a==b;
}
var isMe = booler.uCurry(false,me); // not == false, a = me
isMe(7); // true if me == 7, false if me != 7
 
var isNotMe = booler.uCurry(true,me);
isMe(7); // true if me != 7, false if me == 7

A good example is shown in Object.uAddProperty() example using a curried allianceExistsBetween() function.