net.sf.mmm.util.math.base

Class MathUtilLimitedImpl

java.lang.Object

net.sf.mmm.util.component.base.AbstractComponent

net.sf.mmm.util.component.base.AbstractLoggableComponent

net.sf.mmm.util.math.base.MathUtilLimitedImpl

All Implemented Interfaces:

MathUtilLimited

Direct Known Subclasses:

MathUtilImpl

public class MathUtilLimitedImpl
extends AbstractLoggableComponent
implements MathUtilLimited

This class is a collection of utility functions for dealing with numbers.

Since:

1.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Constructor Summary

Constructors

Constructor and Description
MathUtilLimitedImpl() The constructor.

Method Summary

Modifier and Type	Method and Description
NumberType<? extends Number>	getNumberType(Class<?> numericType) This method gets the NumberType for the given numericType.
<NUMBER extends Number> NumberType<NUMBER>	getNumberTypeGeneric(Class<NUMBER> numericType) This method gets the NumberType for the given numericType.
Number	toSimplestNumber(Number value) This method converts the given value to the simplest suitable number-type.

Methods inherited from class net.sf.mmm.util.component.base.AbstractLoggableComponent

createLogger, doInitialize, getLogger

Methods inherited from class net.sf.mmm.util.component.base.AbstractComponent

doInitialized, getInitializationState, initialize

Methods inherited from class java.lang.Object

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

Constructor Detail

MathUtilLimitedImpl

public MathUtilLimitedImpl()

The constructor.

Method Detail

getNumberType

public NumberType<? extends Number> getNumberType(Class<?> numericType)

This method gets the NumberType for the given numericType.

Specified by:

getNumberType in interface MathUtilLimited

Parameters:

numericType - is the class reflecting a Number. It may be primitive (such as int.class). The signature is NOT bound to Number to make it easy for the caller (e.g. Number.class.isAssignableFrom(int.class) is false).

Returns:

the NumberType representing the given numericType or null if the given numericType is no Number or is NOT known (you may extend this MathUtilLimited in such case).

See Also:

MathUtilLimited.getNumberTypeGeneric(Class)

getNumberTypeGeneric

public <NUMBER extends Number> NumberType<NUMBER> getNumberTypeGeneric(Class<NUMBER> numericType)

This method gets the NumberType for the given numericType.

Specified by:

getNumberTypeGeneric in interface MathUtilLimited

Type Parameters:

NUMBER - is the generic type of the numericType.

Parameters:

numericType - is the class reflecting a Number. It may be primitive (such as int.class).

Returns:

the NumberType representing the given numericType or null if the given numericType is NOT known (you may extend this MathUtilLimited in such case).

toSimplestNumber

public Number toSimplestNumber(Number value)

This method converts the given value to the simplest suitable number-type. The ordering implied by "simplest" is Byte < Short < Integer < Long < Float < Double.
Please note that a decimal Double is only converted to Float if the result is exactly the same. Be aware that 0.2F - 0.2 is NOT 0.0 (but 2.980232227667301E-9).

Specified by:

toSimplestNumber in interface MathUtilLimited

Parameters:

value - is the value to convert.

Returns:

a number with the same Number.doubleValue() as the given value and the simplest possible type.