org.libj.util

Class Numbers.Unsigned

java.lang.Object

org.libj.util.Numbers.Unsigned

Enclosing class:

Numbers

public static final class Numbers.Unsigned
extends Object

Utility functions to convert between signed and unsigned numbers.

Field Summary

Fields

Modifier and Type	Field and Description
static BigInteger	UNSIGNED_LONG_MAX_VALUE Max value of an unsigned long: 2^64 - 1.

Method Summary

Modifier and Type	Method and Description
static short	toSigned(byte unsigned) Returns the value of the specified unsigned byte as a signed short.
static BigInteger	toSigned(byte[] unsigned) Returns the value of the specified byte array representing an unsigned value as a signed BigInteger.
static long	toSigned(int unsigned) Returns the value of the specified unsigned int as a signed long.
static BigInteger	toSigned(long unsigned) Returns the value of the specified unsigned long as a signed BigInteger.
static int	toSigned(short unsigned) Returns the value of the specified unsigned short as a signed int.
static byte[]	toUnsigned(BigInteger signed) Returns the unsigned representation of the signed value as a byte array.
static byte	toUnsigned(byte signed) Returns the unsigned representation of the signed value.
static int	toUnsigned(int signed) Returns the unsigned representation of the signed value.
static long	toUnsigned(long signed) Returns the unsigned representation of the signed value.
static short	toUnsigned(short signed) Returns the unsigned representation of the signed value.

Methods inherited from class java.lang.Object

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

Field Detail

UNSIGNED_LONG_MAX_VALUE

public static final BigInteger UNSIGNED_LONG_MAX_VALUE

Max value of an unsigned long: 2^64 - 1.

Method Detail

toSigned

public static short toSigned(byte unsigned)

Returns the value of the specified unsigned byte as a signed short.

Parameters:

unsigned - The unsigned byte.

Returns:

The value of the specified unsigned byte as a signed short.

toSigned

public static int toSigned(short unsigned)

Returns the value of the specified unsigned short as a signed int.

Parameters:

unsigned - The unsigned short.

Returns:

The value of the specified unsigned short as a signed int.

toSigned

public static long toSigned(int unsigned)

Returns the value of the specified unsigned int as a signed long.

Parameters:

unsigned - The unsigned int.

Returns:

The value of the specified unsigned int as a signed long.

toSigned

public static BigInteger toSigned(long unsigned)

Returns the value of the specified unsigned long as a signed BigInteger.

Parameters:

unsigned - The unsigned long.

Returns:

The value of the specified unsigned long as a signed BigInteger.

toSigned

public static BigInteger toSigned(byte[] unsigned)

Returns the value of the specified byte array representing an unsigned value as a signed BigInteger.

Parameters:

unsigned - The byte array representing an unsigned value.

Returns:

The value of the specified byte array representing an unsigned value as a signed BigInteger.

toUnsigned

public static byte toUnsigned(byte signed)

Returns the unsigned representation of the signed value. The signed value cannot be less than 0.

Parameters:

signed - The signed value.

Returns:

The unsigned representation of the signed value.

Throws:

IllegalArgumentException - If signed < 0.

toUnsigned

public static short toUnsigned(short signed)

Returns the unsigned representation of the signed value. The signed value cannot be less than 0.

Parameters:

signed - The signed value.

Returns:

The unsigned representation of the signed value.

Throws:

IllegalArgumentException - If signed < 0.

toUnsigned

public static int toUnsigned(int signed)

Returns the unsigned representation of the signed value. The signed value cannot be less than 0.

Parameters:

signed - The signed value.

Returns:

The unsigned representation of the signed value.

Throws:

IllegalArgumentException - If signed < 0.

toUnsigned

public static long toUnsigned(long signed)

Returns the unsigned representation of the signed value. The signed value cannot be less than 0.

Parameters:

signed - The signed value.

Returns:

The unsigned representation of the signed value.

Throws:

IllegalArgumentException - If signed < 0.

toUnsigned

public static byte[] toUnsigned(BigInteger signed)

Returns the unsigned representation of the signed value as a byte array. The signed value cannot be less than 0.

Parameters:

signed - The signed value.

Returns:

The unsigned representation of the signed value as a byte array.

Throws:

IllegalArgumentException - If signed < 0.