Package ai.timefold.solver.core.impl.domain.valuerange.buildin.bigdecimal

Class BigDecimalValueRange

java.lang.Object

ai.timefold.solver.core.impl.domain.valuerange.AbstractCountableValueRange<BigDecimal>

ai.timefold.solver.core.impl.domain.valuerange.buildin.bigdecimal.BigDecimalValueRange

All Implemented Interfaces:

CountableValueRange<BigDecimal>, ValueRange<BigDecimal>

public final class BigDecimalValueRange
extends AbstractCountableValueRange<BigDecimal>

Constructor Summary

Constructors

Constructor	Description
BigDecimalValueRange(BigDecimal from, BigDecimal to)	All parameters must have the same BigDecimal.scale().
BigDecimalValueRange(BigDecimal from, BigDecimal to, BigDecimal incrementUnit)	All parameters must have the same BigDecimal.scale().

Method Summary

Modifier and Type	Method	Description
boolean	contains(BigDecimal value)
@NonNull Iterator<BigDecimal>	createOriginalIterator()	Select the elements in original (natural) order.
@NonNull Iterator<BigDecimal>	createRandomIterator(@NonNull Random workingRandom)	Select in random order, but without shuffling the elements.
BigDecimal	get(long index)	Used by uniform random selection in a composite CountableValueRange, or one which includes nulls.
long	getSize()	Used by uniform random selection in a composite CountableValueRange, or one which includes nulls.
String	toString()

Methods inherited from class ai.timefold.solver.core.impl.domain.valuerange.AbstractCountableValueRange

isEmpty

Methods inherited from class java.lang.Object

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

Constructor Details

BigDecimalValueRange

public BigDecimalValueRange(BigDecimal from,
 BigDecimal to)

All parameters must have the same BigDecimal.scale().

Parameters:

from - never null, inclusive minimum

to - never null, exclusive maximum, >= from

BigDecimalValueRange

public BigDecimalValueRange(BigDecimal from,
 BigDecimal to,
 BigDecimal incrementUnit)

All parameters must have the same BigDecimal.scale().

Parameters:

from - never null, inclusive minimum

to - never null, exclusive maximum, >= from

incrementUnit - never null, > 0

Method Details

getSize

public long getSize()

Description copied from interface: CountableValueRange

Used by uniform random selection in a composite CountableValueRange, or one which includes nulls.

Returns:

the exact number of elements generated by this CountableValueRange, always >= 0

get

public BigDecimal get(long index)

Description copied from interface: CountableValueRange

Used by uniform random selection in a composite CountableValueRange, or one which includes nulls.

Parameters:

index - always < CountableValueRange.getSize()

Returns:

sometimes null (if PlanningVariable.allowsUnassigned() is true)

contains

public boolean contains(BigDecimal value)

Parameters:

value - sometimes null

Returns:

true if the ValueRange contains that value

createOriginalIterator

public @NonNull Iterator<BigDecimal> createOriginalIterator()

Description copied from interface: CountableValueRange

Select the elements in original (natural) order.

createRandomIterator

public @NonNull Iterator<BigDecimal> createRandomIterator(@NonNull Random workingRandom)

Description copied from interface: ValueRange

Select in random order, but without shuffling the elements. Each element might be selected multiple times. Scales well because it does not require caching.

Parameters:

workingRandom - the Random to use when any random number is needed, so runs are reproducible.

toString

public String toString()

Overrides:

toString in class Object