Package com.singularsys.jep.functions

Class NaryBinaryFunction

java.lang.Object

com.singularsys.jep.functions.PostfixMathCommand

com.singularsys.jep.functions.NaryBinaryFunction

All Implemented Interfaces:

PostfixMathCommandI, Serializable

Direct Known Subclasses:

Add, Concat, JepTest.MyNaryBinary, Multiply

public abstract class NaryBinaryFunction
extends PostfixMathCommand

Convenient base class for n-ary functions backed by a binary operation. Defines an Object eval(Object l,Object r) method for calculating the result. The operation must be associative.

Author:

Richard Morris

See Also:

• Serialized Form

Field Summary

Fields inherited from class com.singularsys.jep.functions.PostfixMathCommand

curNumberOfParameters, name, NaN, numberOfParameters

Constructor Summary

Constructors

Constructor	Description
NaryBinaryFunction()

Method Summary

Modifier and Type	Method	Description
boolean	checkNumberOfParameters(int n)	Checks the number of parameters of the function.
final Object	eval(Object[] args)	Evaluate given an array of arguments
abstract Object	eval(Object l, Object r)
static <T> NaryBinaryFunction	instanceOf(Class<T> type, BiFunction<T,T,? super Object> fun)	Create a NaryBinaryFunction from a lambda expression where both arguments are of a specified type.
static NaryBinaryFunction	instanceOf(BiFunction<Object,Object,? super Object> fun)	Create a NaryBinaryFunction from a lambda expression where arguments can be Objects.
final void	run(Stack<Object> stack)	Calls eval(Object, Object)

Methods inherited from class com.singularsys.jep.functions.PostfixMathCommand

asArray, asBool, asDouble, asInt, asLong, asStrictInt, asString, getName, getNumberOfParameters, setCurNumberOfParameters, setName, toString, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

NaryBinaryFunction

public NaryBinaryFunction()

Method Details

checkNumberOfParameters

public boolean checkNumberOfParameters(int n)

Description copied from class: PostfixMathCommand

Checks the number of parameters of the function. Functions which set numberOfParameter=-1 should overload this method

Specified by:

checkNumberOfParameters in interface PostfixMathCommandI

Overrides:

checkNumberOfParameters in class PostfixMathCommand

Parameters:

n - number of parameters function will be called with.

Returns:

false if an illegal number of parameters is supplied, true otherwise.

run

public final void run(Stack<Object> stack)
               throws EvaluationException

Calls eval(Object, Object)

Specified by:

run in interface PostfixMathCommandI

Overrides:

run in class PostfixMathCommand

Parameters:

stack - arguments for function

Throws:

EvaluationException - if function cannot be evaluated

eval

public final Object eval(Object[] args)
                  throws EvaluationException

Evaluate given an array of arguments

Parameters:

args - array of arguments to function, must have at least one element

Returns:

result of function

Throws:

EvaluationException - if empty array

eval

public abstract Object eval(Object l,
 Object r)
                     throws EvaluationException

Throws:

EvaluationException

instanceOf

public static NaryBinaryFunction instanceOf(BiFunction<Object,Object,? super Object> fun)

Create a NaryBinaryFunction from a lambda expression where arguments can be Objects. For example NaryBinaryFunction.instanceOf((x,y) -> ((Number) x).doubleValue() + ((Number) y).doubleValue())

Parameters:

fun - the lambda function

Returns:

a new NaryBinaryFunction instance

Since:

Jep 4.0

instanceOf

public static <T> NaryBinaryFunction instanceOf(Class<T> type,
 BiFunction<T,T,? super Object> fun)

Create a NaryBinaryFunction from a lambda expression where both arguments are of a specified type. For example NaryBinaryFunction.instanceOf(Integer.class, (x,y) -> x * y) The eval(Object[]) and eval(Object, Object) will throw an IllegalParameterException if any argument is not of the correct type.

Type Parameters:

T - type of arguments and return value

Parameters:

type - type of the arguments

fun - the lambda function

Returns:

a new NaryBinaryFunction instance

Since:

Jep 4.0