com.phloc.commons.math

Class MathHelper

java.lang.Object

com.phloc.commons.math.MathHelper

@Immutable
public final class MathHelper
extends Object

Contains several math help routines.

Author:

Philip Helger

Method Summary

Methods

Modifier and Type	Method and Description
static BigDecimal	abs(BigDecimal aValue) This is a sanity method wrapping BigDecimal.abs (double), so that you don't have to think whether you need to invoke the abs method from this class or the one from BigDecimal directly.
static BigInteger	abs(BigInteger aValue) This is a sanity method wrapping BigInteger.abs (double), so that you don't have to think whether you need to invoke the abs method from this class or the one from BigInteger directly.
static double	abs(double dValue) This is a sanity method wrapping Math.abs (double), so that you don't have to think whether you need to invoke the abs method from this class or the one from Math directly.
static float	abs(float fValue) This is a sanity method wrapping Math.abs (float), so that you don't have to think whether you need to invoke the abs method from this class or the one from Math directly.
static int	abs(int nValue) This is a fix for Math.abs as it would return Integer.MIN_VALUE for Integer.MIN_VALUE which is very unexpected.
static long	abs(long nValue) This is a fix for Math.abs as it would return Long.MIN_VALUE for Long.MIN_VALUE which is very unexpected.
static BigDecimal	addPercent(BigDecimal aBase, BigDecimal aPercentage) Add x% to base
static boolean	canConvertLongToInt(long nValue)
static BigDecimal	getDividedBigDecimal(int nDividend, int nDivisor) Get the division result using BigDecimal.
static double	getDividedDouble(int nDividend, int nDivisor) Divides the passed int dividend through the passed divisor (nDividend / nDivisor)
static int	getFractionDigits(BigDecimal aBD) Get the number of effective fraction digits by the specified BigDecimal.
static int	getIntDivided(int nDividend, int nDivisor, RoundingMode eRoundingMode)
static int	getIntDividedCeil(int nDividend, int nDivisor)
static int	getIntDividedFloor(int nDividend, int nDivisor)
static int	getLongAsInt(long nValue, int nFallback)
static long	getLongDivided(long nDividend, long nDivisor, RoundingMode eRoundingMode)
static long	getLongDividedCeil(long nDividend, long nDivisor)
static long	getLongDividedFloor(long nDividend, long nDivisor)
static BigDecimal	getMaxBigDecimal(BigDecimal aValue, BigDecimal... aValues)
static BigInteger	getMaxBigInteger(BigInteger aValue, BigInteger... aValues)
static double	getMaxDouble(double dValue, double... aValues)
static double	getMaxFloat(float fValue, float... aValues)
static int	getMaxInt(int nValue, int... aValues)
static long	getMaxLong(long nValue, long... aValues)
static BigDecimal	getMinBigDecimal(BigDecimal aValue, BigDecimal... aValues)
static BigInteger	getMinBigInteger(BigInteger aValue, BigInteger... aValues)
static double	getMinDouble(double dValue, double... aValues)
static double	getMinFloat(float fValue, float... aValues)
static int	getMinInt(int nValue, int... aValues)
static long	getMinLong(long nValue, long... aValues)
static BigDecimal	getPercentValue(BigDecimal aBase, BigDecimal aPercentage) Get x% from base
static BigDecimal	getPercentValue(BigDecimal aBase, BigDecimal aPercentage, int nScale, RoundingMode eRoundingMode) Get x% from base with rounding etc.
static long	getUnsignedInt(int a) Converts the passed signed integer to an unsigned long
static BigDecimal	getWithoutTrailingZeroes(BigDecimal aValue) Get the passed BigDecimal without any trailing zeroes.
static BigDecimal	getWithoutTrailingZeroes(String sValue) Get the passed String as a BigDecimal without any trailing zeroes.
static double	hypot(double a, double b)
static boolean	isEqualTo100(BigDecimal aValue)
static boolean	isEqualTo100(BigInteger aValue)
static boolean	isEqualToOne(BigDecimal aValue)
static boolean	isEqualToOne(BigInteger aValue)
static boolean	isEqualToTen(BigDecimal aValue)
static boolean	isEqualToTen(BigInteger aValue)
static boolean	isEqualToZero(BigDecimal aValue)
static boolean	isEqualToZero(BigInteger aValue)
static boolean	isGreaterOrEqualThan100(BigDecimal aValue)
static boolean	isGreaterOrEqualThan100(BigInteger aValue)
static boolean	isGreaterOrEqualThanOne(BigDecimal aValue)
static boolean	isGreaterOrEqualThanOne(BigInteger aValue)
static boolean	isGreaterOrEqualThanTen(BigDecimal aValue)
static boolean	isGreaterOrEqualThanTen(BigInteger aValue)
static boolean	isGreaterOrEqualThanZero(BigDecimal aValue)
static boolean	isGreaterOrEqualThanZero(BigInteger aValue)
static boolean	isGreaterThan100(BigDecimal aValue)
static boolean	isGreaterThan100(BigInteger aValue)
static boolean	isGreaterThanOne(BigDecimal aValue)
static boolean	isGreaterThanOne(BigInteger aValue)
static boolean	isGreaterThanTen(BigDecimal aValue)
static boolean	isGreaterThanTen(BigInteger aValue)
static boolean	isGreaterThanZero(BigDecimal aValue)
static boolean	isGreaterThanZero(BigInteger aValue)
static boolean	isLowerOrEqualThan100(BigDecimal aValue)
static boolean	isLowerOrEqualThan100(BigInteger aValue)
static boolean	isLowerOrEqualThanOne(BigDecimal aValue)
static boolean	isLowerOrEqualThanOne(BigInteger aValue)
static boolean	isLowerOrEqualThanTen(BigDecimal aValue)
static boolean	isLowerOrEqualThanTen(BigInteger aValue)
static boolean	isLowerOrEqualThanZero(BigDecimal aValue)
static boolean	isLowerOrEqualThanZero(BigInteger aValue)
static boolean	isLowerThan100(BigDecimal aValue)
static boolean	isLowerThan100(BigInteger aValue)
static boolean	isLowerThanOne(BigDecimal aValue)
static boolean	isLowerThanOne(BigInteger aValue)
static boolean	isLowerThanTen(BigDecimal aValue)
static boolean	isLowerThanTen(BigInteger aValue)
static boolean	isLowerThanZero(BigDecimal aValue)
static boolean	isLowerThanZero(BigInteger aValue)
static boolean	isNotEqualTo100(BigDecimal aValue)
static boolean	isNotEqualTo100(BigInteger aValue)
static boolean	isNotEqualToOne(BigDecimal aValue)
static boolean	isNotEqualToOne(BigInteger aValue)
static boolean	isNotEqualToTen(BigDecimal aValue)
static boolean	isNotEqualToTen(BigInteger aValue)
static boolean	isNotEqualToZero(BigDecimal aValue)
static boolean	isNotEqualToZero(BigInteger aValue)
static BigDecimal	subtractPercent(BigDecimal aBase, BigDecimal aPercentage) Subtract x% from base

Methods inherited from class java.lang.Object

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

Method Detail

getDividedDouble

public static double getDividedDouble(int nDividend,
                      int nDivisor)

Divides the passed int dividend through the passed divisor (nDividend / nDivisor)

Parameters:

nDividend - the dividend

nDivisor - the divisor

Returns:

a double representing the exact quotient. Returns Double.NaN if the divisor is 0.

getDividedBigDecimal

@Nonnull
public static BigDecimal getDividedBigDecimal(int nDividend,
                                      int nDivisor)
                                       throws ArithmeticException

Get the division result using BigDecimal.

Parameters:

nDividend - the dividend

nDivisor - the divisor

Returns:

the result of the division

Throws:

ArithmeticException - if the divisor is 0.

getIntDividedCeil

public static int getIntDividedCeil(int nDividend,
                    int nDivisor)

getIntDividedFloor

public static int getIntDividedFloor(int nDividend,
                     int nDivisor)

getIntDivided

public static int getIntDivided(int nDividend,
                int nDivisor,
                @Nonnull
                RoundingMode eRoundingMode)

getLongDividedCeil

public static long getLongDividedCeil(long nDividend,
                      long nDivisor)

getLongDividedFloor

public static long getLongDividedFloor(long nDividend,
                       long nDivisor)

getLongDivided

public static long getLongDivided(long nDividend,
                  long nDivisor,
                  @Nonnull
                  RoundingMode eRoundingMode)

canConvertLongToInt

public static boolean canConvertLongToInt(long nValue)

getLongAsInt

@CheckReturnValue
public static int getLongAsInt(long nValue,
                                int nFallback)

getMaxInt

public static int getMaxInt(int nValue,
            @Nonnull
            int... aValues)

getMaxLong

public static long getMaxLong(long nValue,
              @Nonnull
              long... aValues)

getMaxFloat

public static double getMaxFloat(float fValue,
                 @Nonnull
                 float... aValues)

getMaxDouble

public static double getMaxDouble(double dValue,
                  @Nonnull
                  double... aValues)

getMaxBigDecimal

@Nonnull
public static BigDecimal getMaxBigDecimal(@Nonnull
                                  BigDecimal aValue,
                                  @Nonnull
                                  BigDecimal... aValues)

getMaxBigInteger

@Nonnull
public static BigInteger getMaxBigInteger(@Nonnull
                                  BigInteger aValue,
                                  @Nonnull
                                  BigInteger... aValues)

getMinInt

public static int getMinInt(int nValue,
            @Nonnull
            int... aValues)

getMinLong

public static long getMinLong(long nValue,
              @Nonnull
              long... aValues)

getMinFloat

public static double getMinFloat(float fValue,
                 @Nonnull
                 float... aValues)

getMinDouble

public static double getMinDouble(double dValue,
                  @Nonnull
                  double... aValues)

getMinBigDecimal

@Nonnull
public static BigDecimal getMinBigDecimal(@Nonnull
                                  BigDecimal aValue,
                                  @Nonnull
                                  BigDecimal... aValues)

getMinBigInteger

@Nonnull
public static BigInteger getMinBigInteger(@Nonnull
                                  BigInteger aValue,
                                  @Nonnull
                                  BigInteger... aValues)

abs

@Nonnegative
public static int abs(int nValue)

This is a fix for Math.abs as it would return Integer.MIN_VALUE for Integer.MIN_VALUE which is very unexpected. Instead an exception is thrown.

Parameters:

nValue - Input value

Returns:

the absolute value of the argument.

Throws:

IllegalArgumentException - if the input value is Integer.MIN_VALUE

abs

@Nonnegative
public static long abs(long nValue)

This is a fix for Math.abs as it would return Long.MIN_VALUE for Long.MIN_VALUE which is very unexpected. Instead an exception is thrown.

Parameters:

nValue - Input value

Returns:

the absolute value of the argument.

Throws:

IllegalArgumentException - if the input value is Long.MIN_VALUE

abs

@Nonnegative
public static float abs(float fValue)

This is a sanity method wrapping Math.abs (float), so that you don't have to think whether you need to invoke the abs method from this class or the one from Math directly.

Parameters:

fValue - Input value

Returns:

the absolute value of the argument.

abs

@Nonnegative
public static double abs(double dValue)

This is a sanity method wrapping Math.abs (double), so that you don't have to think whether you need to invoke the abs method from this class or the one from Math directly.

Parameters:

dValue - Input value

Returns:

the absolute value of the argument.

abs

@Nonnull
public static BigDecimal abs(@Nonnull
                     BigDecimal aValue)

This is a sanity method wrapping BigDecimal.abs (double), so that you don't have to think whether you need to invoke the abs method from this class or the one from BigDecimal directly.

Parameters:

aValue - Input value

Returns:

the absolute value of the argument.

abs

@Nonnull
public static BigInteger abs(@Nonnull
                     BigInteger aValue)

This is a sanity method wrapping BigInteger.abs (double), so that you don't have to think whether you need to invoke the abs method from this class or the one from BigInteger directly.

Parameters:

aValue - Input value

Returns:

the absolute value of the argument.

isEqualToZero

public static boolean isEqualToZero(@Nonnull
                    BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 0.

isNotEqualToZero

public static boolean isNotEqualToZero(@Nonnull
                       BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 0.

isLowerThanZero

public static boolean isLowerThanZero(@Nonnull
                      BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 0.

isLowerOrEqualThanZero

public static boolean isLowerOrEqualThanZero(@Nonnull
                             BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 0.

isGreaterThanZero

public static boolean isGreaterThanZero(@Nonnull
                        BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 0.

isGreaterOrEqualThanZero

public static boolean isGreaterOrEqualThanZero(@Nonnull
                               BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 0.

isEqualToOne

public static boolean isEqualToOne(@Nonnull
                   BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 1.

isNotEqualToOne

public static boolean isNotEqualToOne(@Nonnull
                      BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 1.

isLowerThanOne

public static boolean isLowerThanOne(@Nonnull
                     BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 1.

isLowerOrEqualThanOne

public static boolean isLowerOrEqualThanOne(@Nonnull
                            BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 1.

isGreaterThanOne

public static boolean isGreaterThanOne(@Nonnull
                       BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 1.

isGreaterOrEqualThanOne

public static boolean isGreaterOrEqualThanOne(@Nonnull
                              BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 1.

isEqualToTen

public static boolean isEqualToTen(@Nonnull
                   BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 10.

isNotEqualToTen

public static boolean isNotEqualToTen(@Nonnull
                      BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 10.

isLowerThanTen

public static boolean isLowerThanTen(@Nonnull
                     BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 10.

isLowerOrEqualThanTen

public static boolean isLowerOrEqualThanTen(@Nonnull
                            BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 10.

isGreaterThanTen

public static boolean isGreaterThanTen(@Nonnull
                       BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 10.

isGreaterOrEqualThanTen

public static boolean isGreaterOrEqualThanTen(@Nonnull
                              BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 10.

isEqualTo100

public static boolean isEqualTo100(@Nonnull
                   BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 100.

isNotEqualTo100

public static boolean isNotEqualTo100(@Nonnull
                      BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 100.

isLowerThan100

public static boolean isLowerThan100(@Nonnull
                     BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 100.

isLowerOrEqualThan100

public static boolean isLowerOrEqualThan100(@Nonnull
                            BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 100.

isGreaterThan100

public static boolean isGreaterThan100(@Nonnull
                       BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 100.

isGreaterOrEqualThan100

public static boolean isGreaterOrEqualThan100(@Nonnull
                              BigDecimal aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 100.

isEqualToZero

public static boolean isEqualToZero(@Nonnull
                    BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 0.

isNotEqualToZero

public static boolean isNotEqualToZero(@Nonnull
                       BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 0.

isLowerThanZero

public static boolean isLowerThanZero(@Nonnull
                      BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 0.

isLowerOrEqualThanZero

public static boolean isLowerOrEqualThanZero(@Nonnull
                             BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 0.

isGreaterThanZero

public static boolean isGreaterThanZero(@Nonnull
                        BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 0.

isGreaterOrEqualThanZero

public static boolean isGreaterOrEqualThanZero(@Nonnull
                               BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 0.

isEqualToOne

public static boolean isEqualToOne(@Nonnull
                   BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 1.

isNotEqualToOne

public static boolean isNotEqualToOne(@Nonnull
                      BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 1.

isLowerThanOne

public static boolean isLowerThanOne(@Nonnull
                     BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 1.

isLowerOrEqualThanOne

public static boolean isLowerOrEqualThanOne(@Nonnull
                            BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 1.

isGreaterThanOne

public static boolean isGreaterThanOne(@Nonnull
                       BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 1.

isGreaterOrEqualThanOne

public static boolean isGreaterOrEqualThanOne(@Nonnull
                              BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 1.

isEqualToTen

public static boolean isEqualToTen(@Nonnull
                   BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 10.

isNotEqualToTen

public static boolean isNotEqualToTen(@Nonnull
                      BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 10.

isLowerThanTen

public static boolean isLowerThanTen(@Nonnull
                     BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 10.

isLowerOrEqualThanTen

public static boolean isLowerOrEqualThanTen(@Nonnull
                            BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 10.

isGreaterThanTen

public static boolean isGreaterThanTen(@Nonnull
                       BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 10.

isGreaterOrEqualThanTen

public static boolean isGreaterOrEqualThanTen(@Nonnull
                              BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 10.

isEqualTo100

public static boolean isEqualTo100(@Nonnull
                   BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is = 100.

isNotEqualTo100

public static boolean isNotEqualTo100(@Nonnull
                      BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is != 100.

isLowerThan100

public static boolean isLowerThan100(@Nonnull
                     BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is < 100.

isLowerOrEqualThan100

public static boolean isLowerOrEqualThan100(@Nonnull
                            BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≤ 100.

isGreaterThan100

public static boolean isGreaterThan100(@Nonnull
                       BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is > 100.

isGreaterOrEqualThan100

public static boolean isGreaterOrEqualThan100(@Nonnull
                              BigInteger aValue)

Parameters:

aValue - Value to compare. May not be null.

Returns:

true if the value is ≥ 100.

getWithoutTrailingZeroes

@Nullable
@CheckReturnValue
public static BigDecimal getWithoutTrailingZeroes(@Nullable
                                                            String sValue)

Get the passed String as a BigDecimal without any trailing zeroes.

Parameters:

sValue - The String to be used as a BigDecimal to be modified. May be null.

Returns:

null if the input value is null.

getWithoutTrailingZeroes

@Nullable
@CheckReturnValue
public static BigDecimal getWithoutTrailingZeroes(@Nullable
                                                            BigDecimal aValue)

Get the passed BigDecimal without any trailing zeroes. Examples:

• new BigDecimal ("0.00000000") --> 0
• new BigDecimal ("10") --> 10
• new BigDecimal ("10.00000000") --> 10
• new BigDecimal ("10.1") --> 10.1
• new BigDecimal ("10.10000000") --> 10.1
• new BigDecimal ("10.345") --> 10.345
• new BigDecimal ("10.3450000000") --> 10.345

Parameters:

aValue - The BigDecimal to be modified. May be null.

Returns:

null if the input value is null.

getFractionDigits

@Nonnegative
public static int getFractionDigits(@Nonnull
                                BigDecimal aBD)

Get the number of effective fraction digits by the specified BigDecimal. Examples:

• new BigDecimal ("10") --> 0
• new BigDecimal ("10.00000000") --> 0
• new BigDecimal ("10.1") --> 1
• new BigDecimal ("10.10000000") --> 1
• new BigDecimal ("10.345") --> 3
• new BigDecimal ("10.3450000000") --> 3

Parameters:

aBD - The BigDecimal to check. May not be null.

Returns:

The minimum number of fraction digits. Always ≥ 0.

addPercent

@Nonnull
public static BigDecimal addPercent(@Nonnull
                            BigDecimal aBase,
                            @Nonnull
                            BigDecimal aPercentage)

Add x% to base

Parameters:

aBase - Base value. May not be null.

aPercentage - Percentage value (0-100). May not be null.

Returns:

base + x% (=aBase * (100 + perc) / 100). Never null.

subtractPercent

@Nonnull
public static BigDecimal subtractPercent(@Nonnull
                                 BigDecimal aBase,
                                 @Nonnull
                                 BigDecimal aPercentage)

Subtract x% from base

Parameters:

aBase - Base value. May not be null.

aPercentage - Percentage value (0-100). May not be null.

Returns:

base - x% (=aBase * (100 - perc) / 100). Never null.

getPercentValue

@Nonnull
public static BigDecimal getPercentValue(@Nonnull
                                 BigDecimal aBase,
                                 @Nonnull
                                 BigDecimal aPercentage)

Get x% from base

Parameters:

aBase - Base value. May not be null.

aPercentage - Percentage value (0-100). May not be null.

Returns:

x% from base (=aBase * perc / 100). Never null.

getPercentValue

@Nonnull
public static BigDecimal getPercentValue(@Nonnull
                                 BigDecimal aBase,
                                 @Nonnull
                                 BigDecimal aPercentage,
                                 @Nonnegative
                                 int nScale,
                                 @Nonnull
                                 RoundingMode eRoundingMode)

Get x% from base with rounding etc.

Parameters:

aBase - Base value. May not be null.

aPercentage - Percentage value (0-100). May not be null.

nScale - Maximum scale to achieve.

eRoundingMode - Rounding mode to used. May not be null.

Returns:

x% from base (=aBase * perc / 100). Never null.

hypot

public static double hypot(double a,
           double b)

Parameters:

a - a

b - b

Returns:

sqrt(a*a + b*b) without under/overflow.

getUnsignedInt

public static long getUnsignedInt(int a)

Converts the passed signed integer to an unsigned long

Parameters:

a - Source int

Returns:

The unsigned long