Class UInt64

  • All Implemented Interfaces:
    Serializable, Comparable<UInt64>

    public class UInt64
    extends Number
    implements Comparable<UInt64>
    Class to represent unsigned 64-bit numbers. Warning: Any functions which take or return a long are restricted to the range of a signed 64bit number. Use the BigInteger methods if you wish access to the full range.
    See Also:
    Serialized Form
    • Field Detail

      • MAX_LONG_VALUE

        public static final long MAX_LONG_VALUE
        Maximum allowed value (when accessed as a long)
        See Also:
        Constant Field Values
      • MAX_BIG_VALUE

        public static final BigInteger MAX_BIG_VALUE
        Maximum allowed value (when accessed as a BigInteger)
    • Constructor Detail

      • UInt64

        public UInt64​(long _value)
        Create a UInt64 from a long.
        Parameters:
        _value - Must be a valid integer within MIN_VALUE–MAX_VALUE
        Throws:
        NumberFormatException - if value is not between MIN_VALUE and MAX_VALUE
      • UInt64

        public UInt64​(long _top,
                      long _bottom)
        Create a UInt64 from two longs.
        Parameters:
        _top - Most significant 4 bytes.
        _bottom - Least significant 4 bytes.
      • UInt64

        public UInt64​(BigInteger _value)
        Create a UInt64 from a BigInteger
        Parameters:
        _value - Must be a valid BigInteger between MIN_VALUE–MAX_BIG_VALUE
        Throws:
        NumberFormatException - if value is not an integer between MIN_VALUE and MAX_BIG_VALUE
      • UInt64

        public UInt64​(String _value)
        Create a UInt64 from a String.
        Parameters:
        _value - Must parse to a valid integer within MIN_VALUE–MAX_BIG_VALUE
        Throws:
        NumberFormatException - if value is not an integer between MIN_VALUE and MAX_BIG_VALUE
    • Method Detail

      • value

        public BigInteger value()
        The value of this as a BigInteger.
        Returns:
        value
      • byteValue

        public byte byteValue()
        The value of this as a byte.
        Overrides:
        byteValue in class Number
      • doubleValue

        public double doubleValue()
        The value of this as a double.
        Specified by:
        doubleValue in class Number
      • floatValue

        public float floatValue()
        The value of this as a float.
        Specified by:
        floatValue in class Number
      • intValue

        public int intValue()
        The value of this as a int.
        Specified by:
        intValue in class Number
      • longValue

        public long longValue()
        The value of this as a long.
        Specified by:
        longValue in class Number
      • shortValue

        public short shortValue()
        The value of this as a short.
        Overrides:
        shortValue in class Number
      • equals

        public boolean equals​(Object o)
        Test two UInt64s for equality.
        Overrides:
        equals in class Object
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object
      • compareTo

        public int compareTo​(UInt64 other)
        Compare two UInt32s.
        Specified by:
        compareTo in interface Comparable<UInt64>
        Parameters:
        other - other uint64
        Returns:
        0 if equal, -ve or +ve if they are different.
      • toString

        public String toString()
        The value of this as a string.
        Overrides:
        toString in class Object
        Returns:
        string
      • top

        public long top()
        Most significant 4 bytes.
        Returns:
        top
      • bottom

        public long bottom()
        Least significant 4 bytes.
        Returns:
        bottom