hussam.math.operations
Class Function

java.lang.Object
hussam.math.operations.Function

All Implemented Interfaces:

Operation, Operator, java.lang.Comparable<Operator>

Direct Known Subclasses:

CustomFunction

public abstract class Function
extends java.lang.Object
implements Operator

This class is an abstract Operator. You should extend this class to have a special reault method. The result method should use the class's functionality.

A Function uses a list of arguments packaged in an
OperationGroup
The Result method should read the arguments stored in the
getOperationGroup()method.

For Example: You can extend this to have a (factorial) implementation.
 The result implementation reads the first argument, from the Function#getOperationGroup() method.
 Then do the job to return the factorial result!

Version:

2.0

Author:

Hussam Al-Mulhim حسام الملحم

See Also:

OperatorFactoryDB, CustomFunction, OperatorFactory

Function

public Function(java.lang.String name,
OperationGroup g,
                java.lang.String discription)

Construcs a new Function given a name, and an Optional OperationGroup, and a discription

Parameters:

name - Name of the Funciton

g - Optional OperationGroup, can be null;

discription - The function description.

Function

public Function(java.lang.String name,
OperationGroup g)

Simpler constructor.

Parameters:

name - function name.

g - Optional OperationGroup.

See Also:

Function(String, OperationGroup, String)

Function

public Function(java.lang.String name)

Simple constructor.

Parameters:

name - Function name.

getDiscription

public java.lang.String getDiscription()

The Function Description.

Returns:

The function description.

getType

public int getType()

Returns Operator.FUNCTION

Specified by:

getType in interface Operator

Returns:

Returns the FUNCTION type. Operator.FUNCTION

setOperationGroup

public void setOperationGroup(OperationGroup group)

Sets the Operations Group.

Parameters:

group - The OperationGroup to be inserted into this Function. From which the result method will calculate the result, based on the argument list inside the OperationGroup.

getOperationGroup

public OperationGroup getOperationGroup()

Returns the OperationGroup

Returns:

the OperationGroup

getOperation

public Operation getOperation(int i)

Returns the Operation at the specified index.

Parameters:

i - the Index of this operation.

Returns:

The operation at that index.

getCurrentArgumentCount

public int getCurrentArgumentCount()

Returns the current number of arguments inside this Function. It gets this number from the operationGroup inserted into this Function.

Returns:

the Current Argument Count

getName

public java.lang.String getName()

Description copied from interface: Operator

Returns the name of this Operator.

Specified by:

getName in interface Operator

Returns:

the name of this operator.

toString

public java.lang.String toString()

Returns a String describing the name of the function and the list of arguments.

Overrides:

toString in class java.lang.Object

Returns:

a describtion of the Function.

compareTo

public int compareTo(Operator p)

Compares the Function with another operator.

Specified by:

compareTo in interface java.lang.Comparable<Operator>

Parameters:

p - The other operator which the method will compare with.

Returns:

1, -1, or 0. indicating larger, smaller, or equal.

checkReady

protected void checkReady(int argumentCount)
                   throws OperatorArgumentMissingException

This can be used as a check for arguments. For example, assume you created a Function that takes 3 arguments, you can call this method checkReady(3) to test if you have already 3 arguments to process, otherwise throws a OperatorArgumentMissingException

Parameters:

argumentCount - The number of arguments to test.

Throws:

OperatorArgumentMissingException - Thrown if the number of arguments contained in this Function is lower than argumentCount.

See Also:

Operand.checkReady()