org.decimal4j.arithmetic

Class Unsigned

java.lang.Object

org.decimal4j.arithmetic.Unsigned

public final class Unsigned
extends Object

Helper class to emulate unsigned 64bit operations.

Method Summary

Modifier and Type	Method and Description
static int	compare(long a, long b) Compares the two specified long values, treating them as unsigned values between 0 and 2^64 - 1 inclusive.
static long	divide(long dividend, long divisor) Returns dividend / divisor, where the dividend and divisor are treated as unsigned 64-bit quantities.
static boolean	isGreater(long one, long two) Compare two longs as if they were unsigned.
static boolean	isLess(long one, long two) Compare two longs as if they were unsigned.
static boolean	isLessOrEqual(long one, long two) Compare two longs as if they were unsigned.

Methods inherited from class java.lang.Object

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

Method Detail

compare

public static final int compare(long a,
                                long b)

Compares the two specified long values, treating them as unsigned values between 0 and 2^64 - 1 inclusive.

From Guava's UnsignedLongs.

Parameters:

a - the first unsigned long to compare

b - the second unsigned long to compare

Returns:

a negative value if a is less than b; a positive value if a is greater than b; or zero if they are equal

isGreater

public static final boolean isGreater(long one,
                                      long two)

Compare two longs as if they were unsigned. Returns true iff one is bigger than two.

Parameters:

one - the first unsigned long to compare

two - the second unsigned long to compare

Returns:

true if one > two

isLess

public static final boolean isLess(long one,
                                   long two)

Compare two longs as if they were unsigned. Returns true iff one is smaller than two.

Parameters:

one - the first unsigned long to compare

two - the second unsigned long to compare

Returns:

true if one < two

isLessOrEqual

public static final boolean isLessOrEqual(long one,
                                          long two)

Compare two longs as if they were unsigned. Returns true iff one is less than or equal to two.

Parameters:

one - the first unsigned long to compare

two - the second unsigned long to compare

Returns:

true if one <= two

divide

public static final long divide(long dividend,
                                long divisor)

Returns dividend / divisor, where the dividend and divisor are treated as unsigned 64-bit quantities.

Parameters:

dividend - the dividend (numerator)

divisor - the divisor (denominator)

Returns:

dividend / divisor

Throws:

ArithmeticException - if divisor is 0