Package org.sellcom.core.math

Class MoreMath

java.lang.Object

org.sellcom.core.math.MoreMath

public class MoreMath
extends java.lang.Object

Mathematical operations.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
static double	absDifference(double x, double y)	Returns the absolute difference of the given numbers.
static float	absDifference(float x, float y)	Returns the absolute difference of the given numbers.
static int	absDifference(int x, int y)	Returns the absolute difference of the given numbers.
static long	absDifference(long x, long y)	Returns the absolute difference of the given numbers.
static java.math.BigDecimal	absDifference(java.math.BigDecimal x, java.math.BigDecimal y)	Returns the absolute difference of the given numbers.
static java.math.BigInteger	absDifference(java.math.BigInteger x, java.math.BigInteger y)	Returns the absolute difference of the given numbers.
static double	absExact(double x)	Returns the absolute value of the given number.
static float	absExact(float x)	Returns the absolute value of the given number.
static int	absExact(int x)	Returns the absolute value of the given number.
static long	absExact(long x)	Returns the absolute value of the given number.
static java.math.BigDecimal	absExact(java.math.BigDecimal x)	Returns the absolute value of the given number.
static java.math.BigInteger	absExact(java.math.BigInteger x)	Returns the absolute value of the given number.
static int	addExact(int x, int y)	Returns the sum of the given numbers.
static long	addExact(long x, long y)	Returns the sum of the given numbers.
static java.math.BigDecimal	addExact(java.math.BigDecimal x, java.math.BigDecimal y)	Returns the sum of the given numbers.
static java.math.BigInteger	addExact(java.math.BigInteger x, java.math.BigInteger y)	Returns the sum of the given numbers.
static int	ceilToMultiple(int number, int base)	Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.
static long	ceilToMultiple(long number, long base)	Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.
static java.math.BigDecimal	ceilToMultiple(java.math.BigDecimal number, java.math.BigDecimal base)	Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.
static java.math.BigInteger	ceilToMultiple(java.math.BigInteger number, java.math.BigInteger base)	Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.
static int	decrementExact(int x)	Returns the given number decremented by one.
static long	decrementExact(long x)	Returns the given number decremented by one.
static java.math.BigInteger	decrementExact(java.math.BigInteger x)	Returns the given number decremented by one.
static boolean	equals(double x, double y, double tolerance)	Checks whether the given numbers are considered equal in the context of the given tolerance.
static boolean	equals(float x, float y, float tolerance)	Checks whether the given numbers are considered equal in the context of the given tolerance.
static int	floorToMultiple(int number, int base)	Returns the largest (closest to positive negative) multiple of the given base that is smaller or equal to the given number.
static long	floorToMultiple(long number, long base)	Returns the largest (closest to positive negative) multiple of the given base that is smaller or equal to the given number.
static java.math.BigDecimal	floorToMultiple(java.math.BigDecimal number, java.math.BigDecimal base)	Returns the largest (closest to positive infinity) multiple of the given base that is smaller or equal to the given number.
static java.math.BigInteger	floorToMultiple(java.math.BigInteger number, java.math.BigInteger base)	Returns the largest (closest to positive negative) multiple of the given base that is smaller or equal to the given number.
static double	fractionalPart(double x)	Returns the fractional part of the given number.
static float	fractionalPart(float x)	Returns the fractional part of the given number.
static java.math.BigDecimal	fractionalPart(java.math.BigDecimal x)	Returns the fractional part of the given number.
static int	gcd(int x, int y)	Returns the greatest common divisor of the given numbers.
static long	gcd(long x, long y)	Returns the greatest common divisor of the given numbers.
static java.math.BigInteger	gcd(java.math.BigInteger x, java.math.BigInteger y)	Returns the greatest common divisor of the given numbers.
static int	incrementExact(int x)	Returns the given number incremented by one.
static long	incrementExact(long x)	Returns the given number incremented by one.
static java.math.BigInteger	incrementExact(java.math.BigInteger x)	Returns the given number incremented by one.
static long	integralPart(double x)	Returns the integral part of the given number.
static int	integralPart(float x)	Returns the integral part of the given number.
static java.math.BigDecimal	integralPart(java.math.BigDecimal x)	Returns the integral part of the given number.
static boolean	isEven(int x)	Checks whether the given number is even.
static boolean	isEven(long x)	Checks whether the given number is even.
static boolean	isEven(java.math.BigInteger x)	Checks whether the given number is even.
static boolean	isOdd(int x)	Checks whether the given number is odd.
static boolean	isOdd(long x)	Checks whether the given number is odd.
static boolean	isOdd(java.math.BigInteger x)	Checks whether the given number is odd.
static int	lcm(int x, int y)	Returns the least common multiple of the given numbers.
static long	lcm(long x, long y)	Returns the least common multiple of the given numbers.
static java.math.BigInteger	lcm(java.math.BigInteger x, java.math.BigInteger y)	Returns the least common multiple of the given numbers.
static int	magnitude(java.math.BigDecimal x)	Returns the magnitude (the number of digits left to the decimal point) of the given number.
static int	multiplyExact(int x, int y)	Returns the product of the given numbers.
static long	multiplyExact(long x, long y)	Returns the product of the given numbers.
static java.math.BigDecimal	multiplyExact(java.math.BigDecimal x, java.math.BigDecimal y)	Returns the product of the given numbers.
static java.math.BigInteger	multiplyExact(java.math.BigInteger x, java.math.BigInteger y)	Returns the product of the given numbers.
static double	negateExact(double x)	Returns the negation of the given number.
static float	negateExact(float x)	Returns the negation of the given number.
static int	negateExact(int x)	Returns the negation of the given number.
static long	negateExact(long x)	Returns the negation of the given number.
static java.math.BigDecimal	negateExact(java.math.BigDecimal x)	Returns the negation of the given number.
static java.math.BigInteger	negateExact(java.math.BigInteger x)	Returns the negation of the given number.
static java.math.BigDecimal	pow(java.math.BigDecimal x, long n, int scale)	Returns the n-th power of the given number.
static int	powExact(int base, int exponent)	Returns the given base raised to the power of the given exponent.
static long	powExact(long base, int exponent)	Returns the given base raised to the power of the given exponent.
static java.math.BigDecimal	root(java.math.BigDecimal x, int n, int scale)	Returns the n-th root of the given number.
static int	roundToMultiple(int number, int base)	Returns a multiple of the given base that is closest to the given number.
static long	roundToMultiple(long number, long base)	Returns a multiple of the given base that is closest to the given number.
static java.math.BigDecimal	roundToMultiple(java.math.BigDecimal number, java.math.BigDecimal base)	Returns a multiple of the given base that is closest to the given number.
static java.math.BigDecimal	roundToMultiple(java.math.BigDecimal number, java.math.BigDecimal base, java.math.RoundingMode roundingMode)	Returns a multiple of the given base that is closest to the given number.
static java.math.BigInteger	roundToMultiple(java.math.BigInteger number, java.math.BigInteger base)	Returns a multiple of the given base that is closest to the given number.
static java.math.BigInteger	roundToMultiple(java.math.BigInteger number, java.math.BigInteger base, java.math.RoundingMode roundingMode)	Returns a multiple of the given base that is closest to the given number.
static int	signum(double x)	Returns the signum of the given value.
static int	signum(float x)	Returns the signum of the given value.
static int	signum(int x)	Returns the signum of the given value.
static int	signum(long x)	Returns the signum of the given value.
static int	signum(java.math.BigDecimal x)	Returns the signum of the given value.
static int	signum(java.math.BigInteger x)	Returns the signum of the given value.
static int	subtractExact(int x, int y)	Returns the difference of the given arguments.
static long	subtractExact(long x, long y)	Returns the difference of the given arguments.
static java.math.BigDecimal	subtractExact(java.math.BigDecimal x, java.math.BigDecimal y)	Returns the difference of the given arguments.
static java.math.BigInteger	subtractExact(java.math.BigInteger x, java.math.BigInteger y)	Returns the difference of the given arguments.
static java.math.BigInteger	toBigIntegerExact(java.math.BigDecimal x)	Returns the BigInteger value of the given number.
static int	toIntExact(double x)	Returns the int value of the given number.
static int	toIntExact(float x)	Returns the int value of the given number.
static int	toIntExact(long x)	Returns the int value of the given number.
static int	toIntExact(java.math.BigDecimal x)	Returns the int value of the given number.
static int	toIntExact(java.math.BigInteger x)	Returns the int value of the given number.
static long	toLongExact(double x)	Returns the long value of the given number.
static long	toLongExact(float x)	Returns the long value of the given number.
static long	toLongExact(java.math.BigDecimal x)	Returns the long value of the given number.
static long	toLongExact(java.math.BigInteger x)	Returns the long value of the given number.
static short	toShortExact(double x)	Returns the short value of the given number.
static short	toShortExact(float x)	Returns the short value of the given number.
static short	toShortExact(int x)	Returns the short value of the given number.
static short	toShortExact(long x)	Returns the short value of the given number.
static short	toShortExact(java.math.BigDecimal x)	Returns the short value of the given number.
static short	toShortExact(java.math.BigInteger x)	Returns the short value of the given number.

Methods inherited from class java.lang.Object

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

Method Detail

absDifference

public static java.math.BigDecimal absDifference(java.math.BigDecimal x,
                                                 java.math.BigDecimal y)

Returns the absolute difference of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

absDifference

public static java.math.BigInteger absDifference(java.math.BigInteger x,
                                                 java.math.BigInteger y)

Returns the absolute difference of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

absDifference

public static double absDifference(double x,
                                   double y)

Returns the absolute difference of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is not finite

java.lang.IllegalArgumentException - if y is not finite

Since:

1.0

absDifference

public static float absDifference(float x,
                                  float y)

Returns the absolute difference of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is not finite

java.lang.IllegalArgumentException - if y is not finite

Since:

1.0

absDifference

public static int absDifference(int x,
                                int y)

Returns the absolute difference of the given numbers.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

absDifference

public static long absDifference(long x,
                                 long y)

Returns the absolute difference of the given numbers.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

absExact

public static java.math.BigDecimal absExact(java.math.BigDecimal x)

Returns the absolute value of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

absExact

public static java.math.BigInteger absExact(java.math.BigInteger x)

Returns the absolute value of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

absExact

public static double absExact(double x)

Returns the absolute value of the given number.

Throws:

java.lang.IllegalArgumentException - if x is NaN

Since:

1.0

absExact

public static float absExact(float x)

Returns the absolute value of the given number.

Throws:

java.lang.IllegalArgumentException - if x is NaN

Since:

1.0

absExact

public static int absExact(int x)

Returns the absolute value of the given number.

Throws:

java.lang.ArithmeticException - if x is equal to Integer.MIN_VALUE

Since:

1.0

absExact

public static long absExact(long x)

Returns the absolute value of the given number.

Throws:

java.lang.ArithmeticException - if x is equal to Long.MIN_VALUE

Since:

1.0

addExact

public static java.math.BigDecimal addExact(java.math.BigDecimal x,
                                            java.math.BigDecimal y)

Returns the sum of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

addExact

public static java.math.BigInteger addExact(java.math.BigInteger x,
                                            java.math.BigInteger y)

Returns the sum of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

addExact

public static int addExact(int x,
                           int y)

Returns the sum of the given numbers.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

addExact

public static long addExact(long x,
                            long y)

Returns the sum of the given numbers.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit a long

Since:

1.0

ceilToMultiple

public static java.math.BigDecimal ceilToMultiple(java.math.BigDecimal number,
                                                  java.math.BigDecimal base)

Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

Since:

1.4

ceilToMultiple

public static java.math.BigInteger ceilToMultiple(java.math.BigInteger number,
                                                  java.math.BigInteger base)

Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

Since:

1.4

ceilToMultiple

public static int ceilToMultiple(int number,
                                 int base)

Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if base is not positive

Since:

1.4

ceilToMultiple

public static long ceilToMultiple(long number,
                                  long base)

Returns the smallest (closest to negative infinity) multiple of the given base that is greater or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if base is not positive

Since:

1.4

decrementExact

public static java.math.BigInteger decrementExact(java.math.BigInteger x)

Returns the given number decremented by one.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

decrementExact

public static int decrementExact(int x)

Returns the given number decremented by one.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

decrementExact

public static long decrementExact(long x)

Returns the given number decremented by one.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit a long

Since:

1.0

equals

public static boolean equals(double x,
                             double y,
                             double tolerance)

Checks whether the given numbers are considered equal in the context of the given tolerance.

Throws:

java.lang.IllegalArgumentException - if x is not finite

java.lang.IllegalArgumentException - if y is not finite

java.lang.IllegalArgumentException - if tolerance is not finite

java.lang.IllegalArgumentException - if tolerance is negative

Since:

1.0

equals

public static boolean equals(float x,
                             float y,
                             float tolerance)

Checks whether the given numbers are considered equal in the context of the given tolerance.

Throws:

java.lang.IllegalArgumentException - if x is not finite

java.lang.IllegalArgumentException - if y is not finite

java.lang.IllegalArgumentException - if tolerance is not finite

java.lang.IllegalArgumentException - if tolerance is negative

Since:

1.0

floorToMultiple

public static java.math.BigDecimal floorToMultiple(java.math.BigDecimal number,
                                                   java.math.BigDecimal base)

Returns the largest (closest to positive infinity) multiple of the given base that is smaller or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

Since:

1.4

floorToMultiple

public static java.math.BigInteger floorToMultiple(java.math.BigInteger number,
                                                   java.math.BigInteger base)

Returns the largest (closest to positive negative) multiple of the given base that is smaller or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

Since:

1.4

floorToMultiple

public static int floorToMultiple(int number,
                                  int base)

Returns the largest (closest to positive negative) multiple of the given base that is smaller or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if base is not positive

Since:

1.4

floorToMultiple

public static long floorToMultiple(long number,
                                   long base)

Returns the largest (closest to positive negative) multiple of the given base that is smaller or equal to the given number.

Throws:

java.lang.IllegalArgumentException - if base is not positive

Since:

1.4

fractionalPart

public static java.math.BigDecimal fractionalPart(java.math.BigDecimal x)

Returns the fractional part of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

fractionalPart

public static double fractionalPart(double x)

Returns the fractional part of the given number.

Throws:

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

fractionalPart

public static float fractionalPart(float x)

Returns the fractional part of the given number.

Throws:

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

gcd

public static java.math.BigInteger gcd(java.math.BigInteger x,
                                       java.math.BigInteger y)

Returns the greatest common divisor of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

gcd

public static int gcd(int x,
                      int y)

Returns the greatest common divisor of the given numbers.

Throws:

java.lang.ArithmeticException - if x is equal to Integer.MIN_VALUE

java.lang.ArithmeticException - if y is equal to Integer.MIN_VALUE

Since:

1.0

gcd

public static long gcd(long x,
                       long y)

Returns the greatest common divisor of the given numbers.

Throws:

java.lang.ArithmeticException - if x is equal to Long.MIN_VALUE

java.lang.ArithmeticException - if y is equal to Long.MIN_VALUE

Since:

1.0

incrementExact

public static java.math.BigInteger incrementExact(java.math.BigInteger x)

Returns the given number incremented by one.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

incrementExact

public static int incrementExact(int x)

Returns the given number incremented by one.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

incrementExact

public static long incrementExact(long x)

Returns the given number incremented by one.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit a long

Since:

1.0

integralPart

public static java.math.BigDecimal integralPart(java.math.BigDecimal x)

Returns the integral part of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.6

integralPart

public static long integralPart(double x)

Returns the integral part of the given number.

Throws:

java.lang.IllegalArgumentException - if x is not finite

Since:

1.6

integralPart

public static int integralPart(float x)

Returns the integral part of the given number.

Throws:

java.lang.IllegalArgumentException - if x is not finite

Since:

1.6

isEven

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

Checks whether the given number is even.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

isEven

public static boolean isEven(int x)

Checks whether the given number is even.

Since:

1.0

isEven

public static boolean isEven(long x)

Checks whether the given number is even.

Since:

1.0

isOdd

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

Checks whether the given number is odd.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

isOdd

public static boolean isOdd(int x)

Checks whether the given number is odd.

Since:

1.0

isOdd

public static boolean isOdd(long x)

Checks whether the given number is odd.

Since:

1.0

lcm

public static java.math.BigInteger lcm(java.math.BigInteger x,
                                       java.math.BigInteger y)

Returns the least common multiple of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

lcm

public static int lcm(int x,
                      int y)

Returns the least common multiple of the given numbers.

Throws:

java.lang.ArithmeticException - if x is equal to Integer.MIN_VALUE

java.lang.ArithmeticException - if y is equal to Integer.MIN_VALUE

Since:

1.0

lcm

public static long lcm(long x,
                       long y)

Returns the least common multiple of the given numbers.

Throws:

java.lang.ArithmeticException - if x is equal to Long.MIN_VALUE

java.lang.ArithmeticException - if y is equal to Long.MIN_VALUE

Since:

1.0

magnitude

public static int magnitude(java.math.BigDecimal x)

Returns the magnitude (the number of digits left to the decimal point) of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.6

multiplyExact

public static java.math.BigDecimal multiplyExact(java.math.BigDecimal x,
                                                 java.math.BigDecimal y)

Returns the product of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

multiplyExact

public static java.math.BigInteger multiplyExact(java.math.BigInteger x,
                                                 java.math.BigInteger y)

Returns the product of the given numbers.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

multiplyExact

public static int multiplyExact(int x,
                                int y)

Returns the product of the given numbers.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

multiplyExact

public static long multiplyExact(long x,
                                 long y)

Returns the product of the given numbers.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit a long

Since:

1.0

negateExact

public static java.math.BigDecimal negateExact(java.math.BigDecimal x)

Returns the negation of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

negateExact

public static java.math.BigInteger negateExact(java.math.BigInteger x)

Returns the negation of the given number.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

negateExact

public static double negateExact(double x)

Returns the negation of the given number.

Throws:

java.lang.IllegalArgumentException - if x is NaN

Since:

1.0

negateExact

public static float negateExact(float x)

Returns the negation of the given number.

Throws:

java.lang.IllegalArgumentException - if x is NaN

Since:

1.0

negateExact

public static int negateExact(int x)

Returns the negation of the given number.

Throws:

java.lang.ArithmeticException - if x is equal to Integer.MIN_VALUE

Since:

1.0

negateExact

public static long negateExact(long x)

Returns the negation of the given number.

Throws:

java.lang.ArithmeticException - if x is equal to Long.MIN_VALUE

Since:

1.0

pow

public static java.math.BigDecimal pow(java.math.BigDecimal x,
                                       long n,
                                       int scale)

Returns the n-th power of the given number.

Powering BigDecimal.ZERO to the value of 0 returns BigDecimal.ONE.

Throws:

java.lang.ArithmeticException - if n is out of range

java.lang.IllegalArgumentException - if x is null

Since:

1.6

powExact

public static int powExact(int base,
                           int exponent)

Returns the given base raised to the power of the given exponent.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

java.lang.IllegalArgumentException - if exponent is negative

Since:

1.6

powExact

public static long powExact(long base,
                            int exponent)

Returns the given base raised to the power of the given exponent.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

java.lang.IllegalArgumentException - if exponent is negative

Since:

1.6

root

public static java.math.BigDecimal root(java.math.BigDecimal x,
                                        int n,
                                        int scale)

Returns the n-th root of the given number.

Throws:

java.lang.ArithmeticException - if x is negative and n is even

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if n is not positive

Since:

1.6

roundToMultiple

public static java.math.BigDecimal roundToMultiple(java.math.BigDecimal number,
                                                   java.math.BigDecimal base)

Returns a multiple of the given base that is closest to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

Since:

1.4

roundToMultiple

public static java.math.BigDecimal roundToMultiple(java.math.BigDecimal number,
                                                   java.math.BigDecimal base,
                                                   java.math.RoundingMode roundingMode)

Returns a multiple of the given base that is closest to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

java.lang.IllegalArgumentException - if roundingMode is null

Since:

1.4

roundToMultiple

public static java.math.BigInteger roundToMultiple(java.math.BigInteger number,
                                                   java.math.BigInteger base)

Returns a multiple of the given base that is closest to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

Since:

1.4

roundToMultiple

public static java.math.BigInteger roundToMultiple(java.math.BigInteger number,
                                                   java.math.BigInteger base,
                                                   java.math.RoundingMode roundingMode)

Returns a multiple of the given base that is closest to the given number.

Throws:

java.lang.IllegalArgumentException - if number is null

java.lang.IllegalArgumentException - if base is null or is not positive

java.lang.IllegalArgumentException - if roundingMode is null

Since:

1.4

roundToMultiple

public static int roundToMultiple(int number,
                                  int base)

Returns a multiple of the given base that is closest to the given number.

Throws:

java.lang.IllegalArgumentException - if base is not positive

Since:

1.4

roundToMultiple

public static long roundToMultiple(long number,
                                   long base)

Returns a multiple of the given base that is closest to the given number.

Throws:

java.lang.IllegalArgumentException - if base is not positive

Since:

1.4

signum

public static int signum(java.math.BigDecimal x)

Returns the signum of the given value.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

signum

public static int signum(java.math.BigInteger x)

Returns the signum of the given value.

Throws:

java.lang.IllegalArgumentException - if x is null

Since:

1.0

signum

public static int signum(double x)

Returns the signum of the given value.

Throws:

java.lang.IllegalArgumentException - if x is NaN

Since:

1.0

signum

public static int signum(float x)

Returns the signum of the given value.

Throws:

java.lang.IllegalArgumentException - if x is NaN

Since:

1.0

signum

public static int signum(int x)

Returns the signum of the given value.

Since:

1.0

signum

public static int signum(long x)

Returns the signum of the given value.

Since:

1.0

subtractExact

public static java.math.BigDecimal subtractExact(java.math.BigDecimal x,
                                                 java.math.BigDecimal y)

Returns the difference of the given arguments.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

subtractExact

public static java.math.BigInteger subtractExact(java.math.BigInteger x,
                                                 java.math.BigInteger y)

Returns the difference of the given arguments.

Throws:

java.lang.IllegalArgumentException - if x is null

java.lang.IllegalArgumentException - if y is null

Since:

1.0

subtractExact

public static int subtractExact(int x,
                                int y)

Returns the difference of the given arguments.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit an int

Since:

1.0

subtractExact

public static long subtractExact(long x,
                                 long y)

Returns the difference of the given arguments.

Throws:

java.lang.ArithmeticException - if the result does not exactly fit a long

Since:

1.0

toBigIntegerExact

public static java.math.BigInteger toBigIntegerExact(java.math.BigDecimal x)

Returns the BigInteger value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toIntExact

public static int toIntExact(java.math.BigDecimal x)

Returns the int value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit an int

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toIntExact

public static int toIntExact(java.math.BigInteger x)

Returns the int value of the given number.

Throws:

java.lang.ArithmeticException - if x does not exactly fit an int

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toIntExact

public static int toIntExact(double x)

Returns the int value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit an int

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

toIntExact

public static int toIntExact(float x)

Returns the int value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit an int

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

toIntExact

public static int toIntExact(long x)

Returns the int value of the given number.

Throws:

java.lang.ArithmeticException - if x does not exactly fit an int

Since:

1.0

toLongExact

public static long toLongExact(java.math.BigDecimal x)

Returns the long value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit a long

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toLongExact

public static long toLongExact(java.math.BigInteger x)

Returns the long value of the given number.

Throws:

java.lang.ArithmeticException - if x does not exactly fit a long

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toLongExact

public static long toLongExact(double x)

Returns the long value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit a long

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

toLongExact

public static long toLongExact(float x)

Returns the long value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit a long

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

toShortExact

public static short toShortExact(java.math.BigDecimal x)

Returns the short value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit a short

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toShortExact

public static short toShortExact(java.math.BigInteger x)

Returns the short value of the given number.

Throws:

java.lang.ArithmeticException - if x does not exactly fit a short

java.lang.IllegalArgumentException - if x is null

Since:

1.0

toShortExact

public static short toShortExact(double x)

Returns the short value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit a short

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

toShortExact

public static short toShortExact(float x)

Returns the short value of the given number.

Throws:

java.lang.ArithmeticException - if x has a non-zero fractional part

java.lang.ArithmeticException - if x does not exactly fit a short

java.lang.IllegalArgumentException - if x is not finite

Since:

1.0

toShortExact

public static short toShortExact(int x)

Returns the short value of the given number.

Throws:

java.lang.ArithmeticException - if x does not exactly fit a short

Since:

1.0

toShortExact

public static short toShortExact(long x)

Returns the short value of the given number.

Throws:

java.lang.ArithmeticException - if x does not exactly fit a short

Since:

1.0