java8.lang

Class Longs

java.lang.Object

java8.lang.Longs

public final class Longs
extends Object

A place for static default implementations of the new Java 8 static methods in the Long class.

Method Summary

Modifier and Type	Method and Description
static int	compare(long x, long y) Compares two long values numerically.
static int	compareUnsigned(long x, long y) Compares two long values numerically treating the values as unsigned.
static long	divideUnsigned(long dividend, long divisor) Returns the unsigned quotient of dividing the first argument by the second where each argument and the result is interpreted as an unsigned value.
static int	hashCode(long value) Returns a hash code for a long value; compatible with Long.hashCode().
static long	max(long a, long b) Returns the greater of two long values as if by calling Math.max.
static long	min(long a, long b) Returns the smaller of two long values as if by calling Math.min.
static long	remainderUnsigned(long dividend, long divisor) Returns the unsigned remainder from dividing the first argument by the second where each argument and the result is interpreted as an unsigned value.
static long	sum(long a, long b) Adds two long values together as per the + operator.

Methods inherited from class java.lang.Object

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

Method Detail

hashCode

public static int hashCode(long value)

Returns a hash code for a long value; compatible with Long.hashCode().

Parameters:

value - the value to hash

Returns:

a hash code value for a long value.

Since:

1.8

divideUnsigned

public static long divideUnsigned(long dividend,
                                  long divisor)

Returns the unsigned quotient of dividing the first argument by the second where each argument and the result is interpreted as an unsigned value.

Note that in two's complement arithmetic, the three other basic arithmetic operations of add, subtract, and multiply are bit-wise identical if the two operands are regarded as both being signed or both being unsigned. Therefore separate addUnsigned, etc. methods are not provided.

Parameters:

dividend - the value to be divided

divisor - the value doing the dividing

Returns:

the unsigned quotient of the first argument divided by the second argument

Since:

1.8

See Also:

remainderUnsigned(long, long)

compare

public static int compare(long x,
                          long y)

Compares two long values numerically. The value returned is identical to what would be returned by:

    Long.valueOf(x).compareTo(Long.valueOf(y))
 

Parameters:

x - the first long to compare

y - the second long to compare

Returns:

the value 0 if x == y; a value less than 0 if x < y; and a value greater than 0 if x > y

Since:

1.7

compareUnsigned

public static int compareUnsigned(long x,
                                  long y)

Compares two long values numerically treating the values as unsigned.

Parameters:

x - the first long to compare

y - the second long to compare

Returns:

the value 0 if x == y; a value less than 0 if x < y as unsigned values; and a value greater than 0 if x > y as unsigned values

Since:

1.8

remainderUnsigned

public static long remainderUnsigned(long dividend,
                                     long divisor)

Returns the unsigned remainder from dividing the first argument by the second where each argument and the result is interpreted as an unsigned value.

Parameters:

dividend - the value to be divided

divisor - the value doing the dividing

Returns:

the unsigned remainder of the first argument divided by the second argument

Since:

1.8

See Also:

divideUnsigned(long, long)

sum

public static long sum(long a,
                       long b)

Adds two long values together as per the + operator.

Parameters:

a - the first operand

b - the second operand

Returns:

the sum of a and b

Since:

1.8

See Also:

BinaryOperator

max

public static long max(long a,
                       long b)

Returns the greater of two long values as if by calling Math.max.

Parameters:

a - the first operand

b - the second operand

Returns:

the greater of a and b

Since:

1.8

See Also:

BinaryOperator

min

public static long min(long a,
                       long b)

Returns the smaller of two long values as if by calling Math.min.

Parameters:

a - the first operand

b - the second operand

Returns:

the smaller of a and b

Since:

1.8

See Also:

BinaryOperator