org.radix.utils.primitives

Class Longs

java.lang.Object

org.radix.utils.primitives.Longs

public final class Longs
extends java.lang.Object

Utilities for manipulating primitive long values.

Method Summary

Modifier and Type	Method and Description
static int	compareUnsigned(long x, long y) Compares two long values numerically treating the values as unsigned.
static byte[]	copyTo(long value, byte[] bytes, int offset) Copy the byte value of value into bytes starting at offset.
static long	fromByteArray(byte[] bytes) Exactly equivalent to fromByteArray(bytes, 0).
static long	fromByteArray(byte[] bytes, int offset) Decode a long from array bytes at offset.
static long	fromBytes(byte b0, byte b1, byte b2, byte b3, byte b4, byte b5, byte b6, byte b7) Assemble a long value from it's component bytes.
static byte[]	toByteArray(long value) Create a byte array of length Long.BYTES, and populate it with value in big-endian order.

Methods inherited from class java.lang.Object

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

Method Detail

toByteArray

public static byte[] toByteArray(long value)

Create a byte array of length Long.BYTES, and populate it with value in big-endian order.

Parameters:

value - The value to convert

Returns:

The resultant byte array.

copyTo

public static byte[] copyTo(long value,
                            byte[] bytes,
                            int offset)

Copy the byte value of value into bytes starting at offset. A total of Long.BYTES will be written to bytes.

Parameters:

value - The value to convert

bytes - The array to write the value into

offset - The offset at which to write the value

Returns:

The value of bytes

fromByteArray

public static long fromByteArray(byte[] bytes)

Exactly equivalent to fromByteArray(bytes, 0).

Parameters:

bytes - The byte array to decode to a long

Returns:

The decoded long value

See Also:

fromByteArray(byte[], int)

fromByteArray

public static long fromByteArray(byte[] bytes,
                                 int offset)

Decode a long from array bytes at offset. Bytes from array bytes[offset] up to and including bytes[offset + Long.BYTES - 1] will be read from array bytes.

Parameters:

bytes - The byte array to decode to a long

offset - The offset within the array to start decoding

Returns:

The decoded long value

fromBytes

public static long fromBytes(byte b0,
                             byte b1,
                             byte b2,
                             byte b3,
                             byte b4,
                             byte b5,
                             byte b6,
                             byte b7)

Assemble a long value from it's component bytes.

Parameters:

b0 - Most significant byte

b1 - Next most significant byte

b2 - …

b3 - …

b4 - …

b5 - …

b6 - Next least significant byte

b7 - Least significant byte

Returns:

The long value represented by the arguments.

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