Package org.hipparchus.util

Class Incrementor

java.lang.Object

org.hipparchus.util.Incrementor

public class Incrementor
extends Object

Utility that increments a counter until a maximum is reached, at which point, the instance will by default throw a MathIllegalStateException. However, the user is able to override this behaviour by defining a custom callback, in order to e.g. select which exception must be thrown.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Incrementor.MaxCountExceededCallback	Defines a method to be called at counter exhaustion.

Constructor Summary

Constructors

Constructor	Description
Incrementor()	Creates an Incrementor.
Incrementor(int max)	Creates an Incrementor.
Incrementor(int max, Incrementor.MaxCountExceededCallback cb)	Creates an Incrementor.

Method Summary

Modifier and Type	Method	Description
boolean	canIncrement()	Checks whether incrementing the counter nTimes is allowed.
boolean	canIncrement(int nTimes)	Checks whether incrementing the counter several times is allowed.
int	getCount()	Gets the current count.
int	getMaximalCount()	Gets the upper limit of the counter.
void	increment()	Adds the increment value to the current iteration count.
void	increment(int nTimes)	Performs multiple increments.
void	reset()	Resets the counter to 0.
Incrementor	withCallback(Incrementor.MaxCountExceededCallback cb)	Creates a new instance with a given callback.
Incrementor	withCount(int value)	Creates a new instance and set the counter to the given value.
Incrementor	withMaximalCount(int max)	Creates a new instance with a given maximal count.

Methods inherited from class java.lang.Object

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

Constructor Detail

Incrementor

public Incrementor()

Creates an Incrementor.

The maximal value will be set to Integer.MAX_VALUE.

Incrementor

public Incrementor(int max)

Creates an Incrementor.

Parameters:

max - Maximal count.

Throws:

MathIllegalArgumentException - if max is negative.

Incrementor

public Incrementor(int max,
                   Incrementor.MaxCountExceededCallback cb)
            throws NullArgumentException

Creates an Incrementor.

Parameters:

max - Maximal count.

cb - Function to be called when the maximal count has been reached.

Throws:

NullArgumentException - if cb is null.

MathIllegalArgumentException - if max is negative.

Method Detail

withCount

public Incrementor withCount(int value)

Creates a new instance and set the counter to the given value.

Parameters:

value - Value of the counter.

Returns:

a new instance.

withMaximalCount

public Incrementor withMaximalCount(int max)

Creates a new instance with a given maximal count. The counter is reset to 0.

Parameters:

max - Maximal count.

Returns:

a new instance.

Throws:

MathIllegalArgumentException - if max is negative.

withCallback

public Incrementor withCallback(Incrementor.MaxCountExceededCallback cb)

Creates a new instance with a given callback. The counter is reset to 0.

Parameters:

cb - Callback to be called at counter exhaustion.

Returns:

a new instance.

getMaximalCount

public int getMaximalCount()

Gets the upper limit of the counter.

Returns:

the counter upper limit.

getCount

public int getCount()

Gets the current count.

Returns:

the current count.

canIncrement

public boolean canIncrement()

Checks whether incrementing the counter nTimes is allowed.

Returns:

false if calling increment() will trigger a MathIllegalStateException, true otherwise.

canIncrement

public boolean canIncrement(int nTimes)

Checks whether incrementing the counter several times is allowed.

Parameters:

nTimes - Number of increments.

Returns:

false if calling increment(nTimes) would call the callback true otherwise.

Throws:

MathIllegalArgumentException - if nTimes is negative.

increment

public void increment(int nTimes)

Performs multiple increments.

Parameters:

nTimes - Number of increments.

Throws:

MathIllegalArgumentException - if nTimes is negative.

See Also:

increment()

increment

public void increment()

Adds the increment value to the current iteration count. At counter exhaustion, this method will call the trigger method of the callback object passed to the withCallback(MaxCountExceededCallback) method.

See Also:

increment(int)

reset

public void reset()

Resets the counter to 0.