org.matheclipse.core.expression

Class NumberUtil

java.lang.Object

org.matheclipse.core.expression.NumberUtil

public class NumberUtil
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.math.BigInteger	MINUS_ONE

Constructor Summary

Constructors

Constructor and Description
NumberUtil()

Method Summary

Modifier and Type	Method and Description
static java.math.BigInteger	ceiling(org.apache.commons.math4.fraction.BigFraction f) Ceiling, round towards positive infinity.
static java.math.BigInteger	checkNonNegative(java.lang.String role, java.math.BigInteger x)
static double	checkNonNegative(java.lang.String role, double x)
static int	checkNonNegative(java.lang.String role, int x)
static long	checkNonNegative(java.lang.String role, long x)
static java.math.BigInteger	checkPositive(java.lang.String role, java.math.BigInteger x)
static int	checkPositive(java.lang.String role, int x)
static long	checkPositive(java.lang.String role, long x)
static java.math.BigInteger[]	convertToFraction(double value) Convert a double number into a reduced ratio of two BigIntegers that mathematically represents exactly the same value.
static java.math.BigInteger	floor(org.apache.commons.math4.fraction.BigFraction f) Floor, round towards negative infinity.
static org.apache.commons.math4.fraction.BigFraction	fractionalPart(org.apache.commons.math4.fraction.BigFraction f) Fractional part.
static java.math.BigInteger	integerPart(org.apache.commons.math4.fraction.BigFraction f) Integer part.
static org.apache.commons.math4.fraction.BigFraction	inverse(org.apache.commons.math4.fraction.BigFraction fraction)
static boolean	isEven(java.math.BigInteger a)
static boolean	isInt(java.math.BigInteger a, int value) Test if this BigInteger equals the given int value.
static boolean	isLargerThan(org.apache.commons.math4.fraction.BigFraction a, org.apache.commons.math4.fraction.BigFraction b) Compares the absolute value of two rational numbers.
static boolean	isMinusOne(java.math.BigInteger a)
static boolean	isNegative(org.apache.commons.math4.fraction.BigFraction a)
static boolean	isNegative(java.math.BigInteger a)
static boolean	isOdd(java.math.BigInteger a)
static boolean	isOne(java.math.BigInteger a)
static boolean	isPerfectSquare(org.apache.commons.math4.fraction.BigFraction bf) Test if the fraction value is a perfect square (i.e. its numerator's and denominator's square root are integers).
static boolean	isPerfectSquare(java.math.BigInteger bi) Test if the value is a perfect square (i.e. its square root is another integer).
static boolean	isPerfectSquare(IRational bf) Test if the fraction value is a perfect square (i.e. its numerator's and denominator's square root are integers).
static boolean	isPerfectSquare(long n) Test if a long value is a perfect square (i.e. its square root is another integer).
static boolean	isPositive(org.apache.commons.math4.fraction.BigFraction a)
static boolean	isPositive(java.math.BigInteger a)
static boolean	isZero(org.apache.commons.math4.fraction.BigFraction fraction)
static boolean	isZero(java.math.BigInteger a)
static boolean	isZero(IExpr e)
static java.math.BigInteger	round(org.apache.commons.math4.fraction.BigFraction f, int roundMode) Round.
static int	toInt(java.math.BigInteger a) Converts this number to int; unlike #intValue this method raises ArithmeticException if this integer cannot be represented by an int type.
static int	toInt(double d) Converts this number to int; unlike #intValue this method raises ArithmeticException if this integer cannot be represented by an int type.
static long	toLong(java.math.BigInteger a)
static long	toLong(double d) Converts this number to long; unlike #longValue this method raises ArithmeticException if this integer cannot be represented by an long type.
static java.math.BigInteger	trunc(org.apache.commons.math4.fraction.BigFraction f) Truncate, round towards zero.

Methods inherited from class java.lang.Object

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

Field Detail

MINUS_ONE

public static final java.math.BigInteger MINUS_ONE

Constructor Detail

NumberUtil

public NumberUtil()

Method Detail

isZero

public static boolean isZero(IExpr e)

isZero

public static boolean isZero(org.apache.commons.math4.fraction.BigFraction fraction)

inverse

public static org.apache.commons.math4.fraction.BigFraction inverse(org.apache.commons.math4.fraction.BigFraction fraction)

isNegative

public static boolean isNegative(java.math.BigInteger a)

isPositive

public static boolean isPositive(java.math.BigInteger a)

isZero

public static boolean isZero(java.math.BigInteger a)

isOne

public static boolean isOne(java.math.BigInteger a)

isMinusOne

public static boolean isMinusOne(java.math.BigInteger a)

isEven

public static boolean isEven(java.math.BigInteger a)

isOdd

public static boolean isOdd(java.math.BigInteger a)

toLong

public static long toLong(java.math.BigInteger a)
                   throws java.lang.ArithmeticException

Throws:

java.lang.ArithmeticException

toInt

public static int toInt(java.math.BigInteger a)
                 throws java.lang.ArithmeticException

Converts this number to int; unlike #intValue this method raises ArithmeticException if this integer cannot be represented by an int type.

Returns:

the numeric value represented by this integer after conversion to type int.

Throws:

java.lang.ArithmeticException - if conversion to int is not possible.

isInt

public static boolean isInt(java.math.BigInteger a,
                            int value)
                     throws java.lang.ArithmeticException

Test if this BigInteger equals the given int value.

Throws:

java.lang.ArithmeticException

toInt

public static int toInt(double d)
                 throws java.lang.ArithmeticException

Converts this number to int; unlike #intValue this method raises ArithmeticException if this integer cannot be represented by an int type.

Returns:

the numeric value represented by this number after conversion to type int.

Throws:

java.lang.ArithmeticException - if conversion to int is not possible.

toLong

public static long toLong(double d)
                   throws java.lang.ArithmeticException

Converts this number to long; unlike #longValue this method raises ArithmeticException if this integer cannot be represented by an long type.

Returns:

the numeric value represented by this number after conversion to type long.

Throws:

java.lang.ArithmeticException - if conversion to long is not possible.

isLargerThan

public static boolean isLargerThan(org.apache.commons.math4.fraction.BigFraction a,
                                   org.apache.commons.math4.fraction.BigFraction b)

Compares the absolute value of two rational numbers.

Parameters:

that - the rational number to be compared with.

Returns:

|this| > |that|

isNegative

public static boolean isNegative(org.apache.commons.math4.fraction.BigFraction a)

isPositive

public static boolean isPositive(org.apache.commons.math4.fraction.BigFraction a)

floor

public static java.math.BigInteger floor(org.apache.commons.math4.fraction.BigFraction f)

Floor, round towards negative infinity.

Possible loss of precision.

ceiling

public static java.math.BigInteger ceiling(org.apache.commons.math4.fraction.BigFraction f)

Ceiling, round towards positive infinity.

Possible loss of precision.

trunc

public static java.math.BigInteger trunc(org.apache.commons.math4.fraction.BigFraction f)

Truncate, round towards zero.

Possible loss of precision.

integerPart

public static java.math.BigInteger integerPart(org.apache.commons.math4.fraction.BigFraction f)

Integer part.

Possible loss of precision.

fractionalPart

public static org.apache.commons.math4.fraction.BigFraction fractionalPart(org.apache.commons.math4.fraction.BigFraction f)

Fractional part.

Possible loss of precision.

round

public static java.math.BigInteger round(org.apache.commons.math4.fraction.BigFraction f,
                                         int roundMode)

Round.

Round mode is one of { ROUND_UP, ROUND_DOWN, ROUND_CEILING, ROUND_FLOOR, ROUND_HALF_UP, ROUND_HALF_DOWN, ROUND_HALF_EVEN, ROUND_HALF_CEILING, ROUND_HALF_FLOOR, ROUND_HALF_ODD, ROUND_UNNECESSARY, DEFAULT_ROUND_MODE (==ROUND_HALF_UP) .

If rounding isn't necessary, i.e. this BigRational is an integer, [as an optimization] this BigRational is returned.

Possible loss of precision.

isPerfectSquare

public static final boolean isPerfectSquare(java.math.BigInteger bi)

Test if the value is a perfect square (i.e. its square root is another integer). See Stackoverflow.com - Fastest way to determine if an integer's square root is an integer

Parameters:

bi -

Returns:

true if the number is a perfect square.

isPerfectSquare

public static final boolean isPerfectSquare(org.apache.commons.math4.fraction.BigFraction bf)

Test if the fraction value is a perfect square (i.e. its numerator's and denominator's square root are integers). See Stackoverflow.com - Fastest way to determine if an integer's square root is an integer

Parameters:

bf -

Returns:

true if the number is a perfect square.

isPerfectSquare

public static final boolean isPerfectSquare(IRational bf)

Test if the fraction value is a perfect square (i.e. its numerator's and denominator's square root are integers). See Stackoverflow.com - Fastest way to determine if an integer's square root is an integer

Parameters:

bf -

Returns:

true if the number is a perfect square.

isPerfectSquare

public static final boolean isPerfectSquare(long n)

Test if a long value is a perfect square (i.e. its square root is another integer). See Stackoverflow.com - Fastest way to determine if an integer's square root is an integer

Parameters:

n -

Returns:

true if the number is a perfect square.

convertToFraction

public static java.math.BigInteger[] convertToFraction(double value)

Convert a double number into a reduced ratio of two BigIntegers that mathematically represents exactly the same value. See: http:// stackoverflow.com/questions/27259162

Parameters:

value -

Returns:

checkPositive

public static int checkPositive(java.lang.String role,
                                int x)

checkPositive

public static long checkPositive(java.lang.String role,
                                 long x)

checkPositive

public static java.math.BigInteger checkPositive(java.lang.String role,
                                                 java.math.BigInteger x)

checkNonNegative

public static int checkNonNegative(java.lang.String role,
                                   int x)

checkNonNegative

public static long checkNonNegative(java.lang.String role,
                                    long x)

checkNonNegative

public static java.math.BigInteger checkNonNegative(java.lang.String role,
                                                    java.math.BigInteger x)

checkNonNegative

public static double checkNonNegative(java.lang.String role,
                                      double x)