Package org.apache.tuweni.units.bigints

Class BaseUInt64Value<T extends UInt64Value<T>>

java.lang.Object
org.apache.tuweni.units.bigints.BaseUInt64Value<T>
Type Parameters:
T - The concrete type of the value.
All Implemented Interfaces:
Comparable<T>, UInt64Value<T>
public abstract class BaseUInt64Value<T extends UInt64Value<T>> extends Object implements UInt64Value<T>
Base class for UInt64Value.

This class is abstract as it is not meant to be used directly, but it has no abstract methods. As mentioned in UInt64Value, this is used to create strongly-typed type aliases of UInt64. In other words, this allow to "tag" numbers with the unit of what they represent for the type-system, which can help clarity, but also forbid mixing numbers that are mean to be of different units (the strongly-typed part).

This class implements UInt64Value, but also adds a few operations that take a UInt64 directly, for instance multiply(UInt64). The rational is that multiplying a given quantity of something by a "raw" number is always meaningful, and return a new quantity of the same thing.

  • Constructor Details

    • BaseUInt64Value

      protected BaseUInt64Value(UInt64 value, Function<UInt64,T> ctor)
      Parameters:
      value - The value to instantiate this UInt64Value with.
      ctor - A constructor for the concrete type.

    • BaseUInt64Value

      protected BaseUInt64Value(long value, Function<UInt64,T> ctor)
      Parameters:
      value - An unsigned value to instantiate this UInt64Value with.
      ctor - A constructor for the concrete type.

    • BaseUInt64Value

      protected BaseUInt64Value(BigInteger value, Function<UInt64,T> ctor)
      Parameters:
      value - An unsigned value to instantiate this UInt64Value with.
      ctor - A constructor for the concrete type.

  • Method Details

    • copy

      protected T copy()
      Return a copy of this value, or itself if immutable.

      The default implementation of this method returns a copy using the constructor for the concrete type and the bytes returned from toBytes(). Most implementations will want to override this method to instead return this.

      Returns:
      A copy of this value, or itself if immutable.

    • zero

      protected T zero()
      Return the zero value for this type.

      The default implementation of this method returns a value obtained from calling the concrete type constructor with an argument of UInt64.ZERO. Most implementations will want to override this method to instead return a static constant.

      Returns:
      The zero value for this type.

    • add

      public T add(T value)
      Description copied from interface: UInt64Value
      Returns a value that is (this + value).
      Specified by:
      add in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be added to this value.
      Returns:
      this + value

    • add

      public T add(UInt64 value)
      Returns a value that is (this + value).
      Parameters:
      value - The amount to be added to this value.
      Returns:
      this + value

    • add

      public T add(long value)
      Description copied from interface: UInt64Value
      Returns a value that is (this + value).
      Specified by:
      add in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be added to this value.
      Returns:
      this + value

    • addMod

      public T addMod(T value, UInt64 modulus)
      Description copied from interface: UInt64Value
      Returns a value equivalent to ((this + value) mod modulus).
      Specified by:
      addMod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be added to this value.
      modulus - The modulus.
      Returns:
      (this + value) mod modulus

    • addMod

      public T addMod(UInt64 value, UInt64 modulus)
      Returns a value equivalent to ((this + value) mod modulus).
      Parameters:
      value - The amount to be added to this value.
      modulus - The modulus.
      Returns:
      (this + value) mod modulus
      Throws:
      ArithmeticException - modulus == 0.

    • addMod

      public T addMod(long value, UInt64 modulus)
      Description copied from interface: UInt64Value
      Returns a value equivalent to ((this + value) mod modulus).
      Specified by:
      addMod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be added to this value.
      modulus - The modulus.
      Returns:
      (this + value) mod modulus

    • addMod

      public T addMod(long value, long modulus)
      Description copied from interface: UInt64Value
      Returns a value equivalent to ((this + value) mod modulus).
      Specified by:
      addMod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be added to this value.
      modulus - The modulus.
      Returns:
      (this + value) mod modulus

    • subtract

      public T subtract(T value)
      Description copied from interface: UInt64Value
      Returns a value that is (this - value).
      Specified by:
      subtract in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be subtracted from this value.
      Returns:
      this - value

    • subtract

      public T subtract(UInt64 value)
      Returns a value that is (this - value).
      Parameters:
      value - The amount to be subtracted from this value.
      Returns:
      this - value

    • subtract

      public T subtract(long value)
      Description copied from interface: UInt64Value
      Returns a value that is (this - value).
      Specified by:
      subtract in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to be subtracted from this value.
      Returns:
      this - value

    • multiply

      public T multiply(T value)
      Description copied from interface: UInt64Value
      Returns a value that is (this * value).
      Specified by:
      multiply in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to multiply this value by.
      Returns:
      this * value

    • multiply

      public T multiply(UInt64 value)
      Returns a value that is (this * value).
      Parameters:
      value - The amount to multiply this value by.
      Returns:
      this * value

    • multiply

      public T multiply(long value)
      Description copied from interface: UInt64Value
      Returns a value that is (this * value).
      Specified by:
      multiply in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to multiply this value by.
      Returns:
      this * value

    • multiplyMod

      public T multiplyMod(T value, UInt64 modulus)
      Description copied from interface: UInt64Value
      Returns a value that is ((this * value) mod modulus).
      Specified by:
      multiplyMod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to multiply this value by.
      modulus - The modulus.
      Returns:
      (this * value) mod modulus

    • multiplyMod

      public T multiplyMod(UInt64 value, UInt64 modulus)
      Returns a value that is ((this * value) mod modulus).
      Parameters:
      value - The amount to multiply this value by.
      modulus - The modulus.
      Returns:
      (this * value) mod modulus
      Throws:
      ArithmeticException - value < 0 or modulus == 0.

    • multiplyMod

      public T multiplyMod(long value, UInt64 modulus)
      Description copied from interface: UInt64Value
      Returns a value that is ((this * value) mod modulus).
      Specified by:
      multiplyMod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to multiply this value by.
      modulus - The modulus.
      Returns:
      (this * value) mod modulus

    • multiplyMod

      public T multiplyMod(long value, long modulus)
      Description copied from interface: UInt64Value
      Returns a value that is ((this * value) mod modulus).
      Specified by:
      multiplyMod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to multiply this value by.
      modulus - The modulus.
      Returns:
      (this * value) mod modulus

    • divide

      public T divide(T value)
      Description copied from interface: UInt64Value
      Returns a value that is (this / value).
      Specified by:
      divide in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to divide this value by.
      Returns:
      this / value

    • divide

      public T divide(UInt64 value)
      Returns a value that is (this / value).
      Parameters:
      value - The amount to divide this value by.
      Returns:
      this / value
      Throws:
      ArithmeticException - value == 0.

    • divide

      public T divide(long value)
      Description copied from interface: UInt64Value
      Returns a value that is (this / value).
      Specified by:
      divide in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      value - The amount to divide this value by.
      Returns:
      this / value

    • pow

      public T pow(UInt64 exponent)
      Description copied from interface: UInt64Value
      Returns a value that is (this<sup>exponent</sup> mod 2<sup>64</sup>)

      This calculates an exponentiation over the modulus of 2^64.

      Note that exponent is an UInt64 rather than of the type T.

      Specified by:
      pow in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      exponent - The exponent to which this value is to be raised.
      Returns:
      this<sup>exponent</sup> mod 2<sup>64</sup>

    • pow

      public T pow(long exponent)
      Description copied from interface: UInt64Value
      Returns a value that is (this<sup>exponent</sup> mod 2<sup>64</sup>)

      This calculates an exponentiation over the modulus of 2^64.

      Specified by:
      pow in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      exponent - The exponent to which this value is to be raised.
      Returns:
      this<sup>exponent</sup> mod 2<sup>64</sup>

    • mod

      public T mod(UInt64 modulus)
      Description copied from interface: UInt64Value
      Returns a value that is (this mod modulus).
      Specified by:
      mod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      modulus - The modulus.
      Returns:
      this mod modulus.

    • mod

      public T mod(long modulus)
      Description copied from interface: UInt64Value
      Returns a value that is (this mod modulus).
      Specified by:
      mod in interface UInt64Value<T extends UInt64Value<T>>
      Parameters:
      modulus - The modulus.
      Returns:
      this mod modulus.

    • compareTo

      public int compareTo(T other)
      Specified by:
      compareTo in interface Comparable<T extends UInt64Value<T>>

    • compareTo

      public int compareTo(UInt64 other)
      Compare two UInt64 values.
      Parameters:
      other - The value to compare to.
      Returns:
      A negative integer, zero, or a positive integer as this value is less than, equal to, or greater than the specified value.

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • toUInt64

      public UInt64 toUInt64()
      Description copied from interface: UInt64Value
      Convert this value to a UInt64.
      Specified by:
      toUInt64 in interface UInt64Value<T extends UInt64Value<T>>
      Returns:
      This value as a UInt64.

    • toBytes

      public org.apache.tuweni.bytes.Bytes toBytes()
      Description copied from interface: UInt64Value
      Returns the value as bytes.
      Specified by:
      toBytes in interface UInt64Value<T extends UInt64Value<T>>
      Returns:
      The value as bytes.

    • toMinimalBytes

      public org.apache.tuweni.bytes.Bytes toMinimalBytes()
      Description copied from interface: UInt64Value
      Returns the value as bytes without any leading zero bytes.
      Specified by:
      toMinimalBytes in interface UInt64Value<T extends UInt64Value<T>>
      Returns:
      The value as bytes without any leading zero bytes.