Package me.datafox.dfxengine.math.numeral

Class FloatNumeral

java.lang.Object
me.datafox.dfxengine.math.numeral.FloatNumeral
All Implemented Interfaces:
Comparable<Numeral>, Numeral
public final class FloatNumeral extends Object
Implementation of Numeral backed with a float.

  • Constructor Details

    • FloatNumeral

      public FloatNumeral(float number)
      Parameters:
      number - float to be associated with this numeral
      Throws:
      IllegalArgumentException - if the float is NaN or infinite.

  • Method Details

    • getNumber

      public Number getNumber()
      Returns:
      the Number backing this numeral

    • floatValue

      public float floatValue()
      Specified by:
      floatValue in interface Numeral
      Returns:
      the backing float of this numeral

    • bigIntValue

      public BigInteger bigIntValue()
      Conversion from float to BigInteger is done using bigDecValue().toBigInteger(), which uses the String representation to round inaccuracies.
      Specified by:
      bigIntValue in interface Numeral
      Returns:
      the value of this numeral as a BigInteger

    • doubleValue

      public double doubleValue()
      Conversion from float to double is done using the String representation to round inaccuracies.
      Specified by:
      doubleValue in interface Numeral
      Returns:
      the value of this numeral as a double

    • bigDecValue

      public BigDecimal bigDecValue()
      Conversion from float to BigDecimal is done using the String representation to round inaccuracies.
      Specified by:
      bigDecValue in interface Numeral
      Returns:
      the value of this numeral as a BigDecimal

    • getLogger

      protected org.slf4j.Logger getLogger()
      Returns:
      Logger for this numeral

    • getType

      public NumeralType getType()
      Specified by:
      getType in interface Numeral
      Returns:
      the backing Number's type

    • canConvert

      public boolean canConvert(NumeralType type)
      Specified by:
      canConvert in interface Numeral
      Parameters:
      type - type to be checked for
      Returns:
      true if this numeral can be converted to the specified type
      Throws:
      NullPointerException - if the specified type is null
      IllegalArgumentException - if the specified type is not null, but it is not recognised as any of the elements of NumeralType. This should never happen

    • convert

      public Numeral convert(NumeralType type)
      Specified by:
      convert in interface Numeral
      Parameters:
      type - type for this numeral to be converted to
      Returns:
      a numeral backed with the specified type
      Throws:
      ExtendedArithmeticException - if the value of this numeral is outside the provided type's bounds
      NullPointerException - if the specified type is null
      IllegalArgumentException - if the specified type is not null, but it is not recognised as any of the elements of NumeralType. This should never happen

    • convertIfAllowed

      public Numeral convertIfAllowed(NumeralType type)
      Specified by:
      convertIfAllowed in interface Numeral
      Parameters:
      type - type for this numeral to be converted to
      Returns:
      a numeral backed with the specified type, unless the value of this numeral is outside the specified type's bounds, in which case this numeral is returned
      Throws:
      NullPointerException - if the specified type is null
      IllegalArgumentException - if the specified type is not null, but it is not recognised as any of the elements of NumeralType. This should never happen

    • toInteger

      public Numeral toInteger()
      Specified by:
      toInteger in interface Numeral
      Returns:
      a numeral backed with the smallest integer type that can hold this numeral's value, unless this numeral is already an integer, in which case this numeral is returned

    • toDecimal

      public Numeral toDecimal()
      Specified by:
      toDecimal in interface Numeral
      Returns:
      a numeral backed with the smallest decimal type that can hold this numeral's value, unless this numeral is already a decimal, in which case this numeral is returned

    • toSmallestType

      public Numeral toSmallestType()
      Specified by:
      toSmallestType in interface Numeral
      Returns:
      a numeral backed with the smallest type that can hold this numeral's value. This method does not convert between integer and decimal types.

    • intValue

      public int intValue()
      Specified by:
      intValue in interface Numeral
      Returns:
      the value of this numeral as an int
      Throws:
      ExtendedArithmeticException - if the value of this numeral is smaller than Integer.MIN_VALUE or greater than Integer.MAX_VALUE

    • longValue

      public long longValue()
      Specified by:
      longValue in interface Numeral
      Returns:
      the value of this numeral as a long
      Throws:
      ExtendedArithmeticException - if the value of this numeral is smaller than Long.MIN_VALUE or greater than Long.MAX_VALUE

    • toString

      public String toString()
      Overrides:
      toString in class Object
      Returns:
      String representation of this numeral in format Type(value)

    • compareTo

      public int compareTo(Numeral other)
      Compares this numeral with the specified numeral for order. The numerals are compared using Numerals.compare(Numeral, Numeral). Returns a negative integer, zero, or a positive integer as this numeral is less than, equal to, or greater than the specified numeral.
      Specified by:
      compareTo in interface Comparable<Numeral>
      Parameters:
      other - the numeral to be compared
      Returns:
      a negative integer, zero, or a positive integer as this numeral is less than, equal to, or greater than the specified numeral
      Throws:
      NullPointerException - if the Numeral returns null for Numeral.getType()
      IllegalArgumentException - if the Numeral does not return null for Numeral.getType(), but the value is not recognised as any of the values of NumeralType. This should never happen