java.lang.Object
- net.sourceforge.uiq3.math.BCDFraction

All Implemented Interfaces:

Cloneable, Comparable<Number>, Number
```
public final class BCDFraction
extends Object
implements Number
```
Decimal_Fraction Arithmetic.
For the use in an FX-603P Simulator the precision is fixed at 14 decimal digits.

Field Summary

Fields
Modifier and Type	Field	Description
`static @NotNull BCDFraction`	`Approx_e`	e approximation used for unit tests
`static @NotNull BCDFraction`	`Approx_π`	π approximation used for unit tests
`private @NotNull BCDInteger`	`Denominator`	The Denominator:
`private static Logger`	`Logger`	Class logger instance.
`static @NotNull BCDFraction`	`Num_0`	0
`static @NotNull BCDFraction`	`Num_1`	1
`static @NotNull BCDFraction`	`Num_180`	180
`static @NotNull BCDFraction`	`Num_2`	2
`static @NotNull BCDFraction`	`Num_200`	200
`private @NotNull BCDInteger`	`Numerator`	The Numerator:
`private static String`	`TAG`	Class logger tag.
`private static Pattern`	`Values_2`	matches «2/3»
`private static Pattern`	`Values_3`	matches «1 2/3»

Fields inherited from interface net.sourceforge.uiq3.math.Number
Compare_Equal, Compare_Greater, Compare_Less, Effective_Precision, Max_Precision

Constructor Summary

Constructors
Constructor	Description
`BCDFraction(long Whole)`	create new fraction
`BCDFraction(long Whole, long Numerator, long Denominator)`	create new fraction
`BCDFraction(@NotNull String Text)`	create new fraction from a string
`BCDFraction(@NotNull BCDFraction Value)`	create new fraction
`BCDFraction(@NotNull BCDInteger Whole)`	create new fraction
`BCDFraction(@NotNull BCDInteger Numerator, @NotNull BCDInteger Denominator)`	create new fraction
`BCDFraction(@NotNull Number Whole, @NotNull Number Numerator, @NotNull BCDInteger Denominator)`	create new fraction

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`@NotNull Number`	`$div(@NotNull Number y)`	x ÷ y
`@NotNull Number`	`$minus(@NotNull Number y)`	x - y
`@NotNull Number`	`$plus(@NotNull Number y)`	x + y
`@NotNull Number`	`$times(@NotNull Number y)`	x × y
`@NotNull Number`	`$times$times(@NotNull Number y)`	x^y
`@NotNull BCDInteger`	`a()`	Fraktur represented as «a b/c»
`@NotNull Number`	`abs()`	\|x\|
`@NotNull Number`	`and(@NotNull Number y)`	Logical and
`@NotNull Number`	`arc_cos()`	arc cosine
`@NotNull Number`	`arc_cos(@NotNull Number Half_Circle)`	arc cosine
`@NotNull Number`	`arc_cos_hyp()`	area hyperbolic cosine: log_e (x + √(x-1) × √(x+1))
`@NotNull Number`	`arc_sin()`	arc sine
`@NotNull Number`	`arc_sin(@NotNull Number Half_Circle)`	arc sine
`@NotNull Number`	`arc_sin_hyp()`	area hyperbolic sine: log_e (x + √(x² + 1))
`@NotNull Number`	`arc_tan()`	arc tangent
`@NotNull Number`	`arc_tan(@NotNull Number Half_Circle)`	arc tangent
`@NotNull Number`	`arc_tan_hyp()`	area hyperbolic tangent: log_e ((1 + x) ÷ (1 - x)) / 2
`@NotNull BCDFloat`	`As_BCDFloat()`	Either convert to a BCDFloat or return this.
`@NotNull BCDFraction`	`As_BCDFraction()`	Either convert to a or return this.
`@NotNull BCDInteger`	`As_BCDInteger()`	Either convert to a BCDInteger or return this.
`@NotNull BCDInteger`	`b()`	Fraktur represented as «a b/c»
`@NotNull BCDInteger`	`c()`	Fraktur represented as «a b/c» or «d/c»
`@NotNull Object`	`clone()`	clone the float - but it might be easier to use the provided copy Constructor instead.
`@NotNull Number`	`Clone()`	clone the float - but it might be easier to use the provided copy Constructor instead.
`long`	`Coefficient_As_Long()`	coefficient - while a 18 digits number can also be represented as an long an 18digits multiplication need a 36digits temporary and that is more then a long can do.
`int`	`Compare(@NotNull Number Value)`	Compare values
`int`	`compareTo(@NotNull Number rightValue)`
`@NotNull Number`	`cos()`	cos (x)
`@NotNull Number`	`cos(@NotNull Number Half_Circle)`	cosine
`@NotNull Number`	`cos_hyp()`	Hyperbolic cosine: (Exponent^x + Exponent^-x)/2
`@NotNull BCDInteger`	`d()`	Fraktur represented as «d/c».
`byte[]`	`Digits()`	number: sum(i = 0 ...
`boolean`	`equals(@NotNull Object rightValue)`
`@NotNull Number`	`exp_10()`	10^x
`@NotNull Number`	`exp_e()`	e^x
`int`	`Exponent()`	current exponent - note that the exponent is based on the internal representation where the radix point is right most.
`@NotNull Number`	`Fix(int Decimal, int Exponent)`	Round to a given Precision after the decimal point.
`@NotNull Number`	`Frac()`	Recompose a frac double from the given data.
`int`	`hashCode()`
`int`	`Indirect_Value(int Digit_Count)`	Get valuef or indirect addressing.
`@NotNull Number`	`Integer()`	integer part of the BCDFloat
`boolean`	`Is_Finite()`	current value is a normal number
`boolean`	`Is_Infinite()`	current value is Infinity (but not N/A).
`boolean`	`Is_Integer()`	Current value is integer value.
`boolean`	`Is_NaN()`	current value is not a number
`boolean`	`Is_Negative()`	Current value us negative
`boolean`	`Is_Zero()`	value is 0
`@NotNull Number`	`log_10()`	log₁₀ (x)
`@NotNull Number`	`log_e()`	log_e (x)
`@NotNull Number`	`neg()`
`void`	`Normalize()`	normalize the value
`@NotNull Number`	`not()`	Logical not
`int`	`Num_Digits()`	the current number of digits - not that when the number is not normalised there might be more 0's in the number then strictly needed.
`@NotNull Number`	`or(@NotNull Number y)`	Logical or
`@NotNull Number`	`P_To_X(@NotNull Number θ)`	Convert Polar to Rectangle Coordinates
`@NotNull Number`	`P_To_X(@NotNull Number θ, @NotNull Number Half_Circle)`	Convert Polar to Rectangle Coordinates
`@NotNull Number`	`P_To_Y(@NotNull Number θ)`	Convert Polar to Rectangle Coordinates
`@NotNull Number`	`P_To_Y(@NotNull Number θ, @NotNull Number Half_Circle)`	Convert Polar to Rectangle Coordinates
`@NotNull Number`	`R_To_R(@NotNull Number y)`	Convert Rectangle to Polar Coordinates
`@NotNull Number`	`R_To_θ(@NotNull Number y)`	Convert Rectangle to Polar Coordinates
`@NotNull Number`	`R_To_θ(@NotNull Number y, @NotNull Number Half_Circle)`	Convert Rectangle to Polar Coordinates
`@NotNull Number`	`root(@NotNull Number r)`	^r√x
`@NotNull Number`	`Round()`	Round to effective Precision and Exponent.
`@NotNull Number`	`Round(int Precision, int Exponent)`	Round to a given Precision and Exponent.
`@NotNull Number`	`sin()`	sine
`@NotNull Number`	`sin(@NotNull Number Half_Circle)`	sine
`@NotNull Number`	`sin_hyp()`	hyperbolic sine: (e^x - e^-x) ÷ 2
`@NotNull Number`	`square()`	x²
`@NotNull Number`	`square_root()`	²√x
`@NotNull Number`	`tan()`	tan x
`@NotNull Number`	`tan(@NotNull Number Half_Circle)`	tangent
`@NotNull Number`	`tan_hyp()`	Hyperbolic tangent: (e^2x - 1) ÷ (e^2x + 1)
`@NotNull String`	`To_Debug_String()`	convert to native/debug string representation
`int`	`To_Integer()`	Convert to integer
`long`	`To_Long()`	Convert to long integer
`@NotNull String`	`toString()`	display as debug string
`@NotNull Number`	`xor(@NotNull Number y)`	Logical xor

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.sourceforge.uiq3.math.Number
div, minus, plus, pow, times

- Field Detail
  - Logger
```
private static final Logger Logger
```
    Class logger instance.
  - TAG
```
private static final String TAG
```
    Class logger tag.
  - Values_2
```
private static final Pattern Values_2
```
    matches «2/3»
  - Values_3
```
private static final Pattern Values_3
```
    matches «1 2/3»
  - Approx_e
```
@NotNull
public static final @NotNull BCDFraction Approx_e
```
    e approximation used for unit tests
  - Approx_π
```
@NotNull
public static final @NotNull BCDFraction Approx_π
```
    π approximation used for unit tests
  - Num_0
```
@NotNull
public static final @NotNull BCDFraction Num_0
```
    0
  - Num_1
```
@NotNull
public static final @NotNull BCDFraction Num_1
```
    1
  - Num_180
```
@NotNull
public static final @NotNull BCDFraction Num_180
```
    180
  - Num_2
```
@NotNull
public static final @NotNull BCDFraction Num_2
```
    2
  - Num_200
```
@NotNull
public static final @NotNull BCDFraction Num_200
```
    200
  - Denominator
```
@NotNull
private @NotNull BCDInteger Denominator
```
    The Denominator:
    Whole + Numerator / Denominator
  - Numerator
```
@NotNull
private @NotNull BCDInteger Numerator
```
    The Numerator:
    Numerator / Denominator
- Constructor Detail
  - BCDFraction
```
public BCDFraction(@NotNull
                   @NotNull BCDFraction Value)
```
    create new fraction
    
    Parameters:
    
    Value - value to copy
  - BCDFraction
```
public BCDFraction(@NotNull
                   @NotNull BCDInteger Whole)
```
    create new fraction
    
    Parameters:
    
    Whole - The whole part of the number
  - BCDFraction
```
public BCDFraction(@NotNull
                   @NotNull BCDInteger Numerator,
                   @NotNull
                   @NotNull BCDInteger Denominator)
```
    create new fraction
    
    Parameters:
    
    Numerator - The numerator
    
    Denominator - The denominator
  - BCDFraction
```
public BCDFraction(long Whole)
```
    create new fraction
    
    Parameters:
    
    Whole - The whole part of the number
  - BCDFraction
```
public BCDFraction(long Whole,
                   long Numerator,
                   long Denominator)
```
    create new fraction
    
    Parameters:
    
    Whole - The whole part of the number
    
    Numerator - The numerator
    
    Denominator - The denominator
  - BCDFraction
```
public BCDFraction(@NotNull
                   @NotNull Number Whole,
                   @NotNull
                   @NotNull Number Numerator,
                   @NotNull
                   @NotNull BCDInteger Denominator)
```
    create new fraction
    
    Parameters:
    
    Whole - The whole part of the number
    
    Numerator - The numerator
    
    Denominator - The denominator
  - BCDFraction
```
public BCDFraction(@NotNull
                   @NotNull String Text)
```
    create new fraction from a string
    
    Parameters:
    
    Text - A String of the type "999" or “999/999” or "999 999/999"
- Method Detail
  - $div
```
@Contract(pure=true)
@NotNull
public @NotNull Number $div(@NotNull
                            @NotNull Number y)
```
    x ÷ y
    
    Specified by:
    
    $div in interface Number
    
    Parameters:
    
    y - divisor
    
    Returns:
    
    x ÷ y
  - $minus
```
@Contract(pure=true)
@NotNull
public @NotNull Number $minus(@NotNull
                              @NotNull Number y)
```
    x - y
    
    Specified by:
    
    $minus in interface Number
    
    Parameters:
    
    y - value to subtract
    
    Returns:
    
    x - y
  - $plus
```
@Contract(pure=true)
@NotNull
public @NotNull Number $plus(@NotNull
                             @NotNull Number y)
```
    x + y
    
    Specified by:
    
    $plus in interface Number
    
    Parameters:
    
    y - value to add
    
    Returns:
    
    x + y
  - $times
```
@Contract(pure=true)
@NotNull
public @NotNull Number $times(@NotNull
                              @NotNull Number y)
```
    x × y
    
    Specified by:
    
    $times in interface Number
    
    Parameters:
    
    y - Multiplier
    
    Returns:
    
    x × y
  - $times$times
```
@Contract(pure=true)
@NotNull
public @NotNull Number $times$times(@NotNull
                                    @NotNull Number y)
                             throws BCDError
```
    x^y
    
    Specified by:
    
    $times$times in interface Number
    
    Parameters:
    
    y - power
    
    Returns:
    
    x^y
    
    Throws:
    
    BCDError - calculation error
  - As_BCDFloat
```
@NotNull
public @NotNull BCDFloat As_BCDFloat()
```
    Either convert to a BCDFloat or return this.
    
    Specified by:
    
    As_BCDFloat in interface Number
    
    Returns:
    
    value as java int
  - As_BCDFraction
```
@NotNull
public @NotNull BCDFraction As_BCDFraction()
```
    Either convert to a or return this.
    
    Specified by:
    
    As_BCDFraction in interface Number
    
    Returns:
    
    value as java int
  - As_BCDInteger
```
@NotNull
public @NotNull BCDInteger As_BCDInteger()
```
    Either convert to a BCDInteger or return this.
    
    Specified by:
    
    As_BCDInteger in interface Number
    
    Returns:
    
    value as java int
  - Clone
```
@NotNull
public @NotNull Number Clone()
```
    clone the float - but it might be easier to use the provided copy Constructor instead.
    
    Specified by:
    
    Clone in interface Number
    
    Returns:
    
    a new BCDFloat from an existing one.
    
    See Also:
    
    Object.clone()
  - Coefficient_As_Long
```
public long Coefficient_As_Long()
                         throws BCDError
```
    coefficient - while a 18 digits number can also be represented as an long an 18digits multiplication need a 36digits temporary and that is more then a long can do.
    
    Specified by:
    
    Coefficient_As_Long in interface Number
    
    Returns:
    
    Coefficient
    
    Throws:
    
    BCDError - when it's not a normal number
  - Compare
```
public int Compare(@NotNull
                   @NotNull Number Value)
```
    Compare values
    
    Specified by:
    
    Compare in interface Number
    
    Parameters:
    
    Value - Value to compare with
    
    Returns:
    
    Compare_Equal
    
    Values are the same
    
    Compare_Less
    
    Left value less the right value
    
    Compare_Greater
    
    Left value greater the right value
  - Digits
```
public byte[] Digits()
```
    number: sum(i = 0 ... Num_Digits-1; Digits[i]*10^i)
    
    Specified by:
    
    Digits in interface Number
  - Exponent
```
public int Exponent()
             throws BCDError
```
    current exponent - note that the exponent is based on the internal representation where the radix point is right most. For example π is 314159265358979324×10^-17.
    
    Specified by:
    
    Exponent in interface Number
    
    Returns:
    
    Current exponent.
    
    Throws:
    
    BCDError - when the value is not finite
  - Fix
```
@NotNull
public @NotNull Number Fix(int Decimal,
                           int Exponent)
```
    Round to a given Precision after the decimal point.
    
    Specified by:
    
    Fix in interface Number
    
    Parameters:
    
    Decimal - decimal digits to keep
    
    Exponent - max exponent
    
    Returns:
    
    rounded value
  - Frac
```
@NotNull
public @NotNull Number Frac()
```
    Recompose a frac double from the given data.
    
    Specified by:
    
    Frac in interface Number
    
    Returns:
    
    a double
  - Indirect_Value
```
public int Indirect_Value(int Digit_Count)
```
    Get valuef or indirect addressing.
    
    Specified by:
    
    Indirect_Value in interface Number
    
    Parameters:
    
    Digit_Count - Should be 1 … 2 depending if value is used to access memory or perform a goto.
    
    Returns:
    
    int value for indirect addressing.
  - Integer
```
@NotNull
public @NotNull Number Integer()
```
    integer part of the BCDFloat
    
    Do not mix up with To_Integer - This version returns another BCDFloat!
    
    Specified by:
    
    Integer in interface Number
    
    Returns:
    
    integer part of this
  - Is_Finite
```
public boolean Is_Finite()
```
    current value is a normal number
    
    Specified by:
    
    Is_Finite in interface Number
    
    Returns:
    
    true when it is a normal number
  - Is_Infinite
```
public boolean Is_Infinite()
```
    current value is Infinity (but not N/A).
    
    Specified by:
    
    Is_Infinite in interface Number
    
    Returns:
    
    true when x is infinite
  - Is_Integer
```
public boolean Is_Integer()
```
    Current value is integer value.
    
    Specified by:
    
    Is_Integer in interface Number
    
    Returns:
    
    true when x is an integer number
  - Is_NaN
```
public boolean Is_NaN()
```
    current value is not a number
    
    Specified by:
    
    Is_NaN in interface Number
    
    Returns:
    
    when is not a number
  - Is_Negative
```
public boolean Is_Negative()
```
    Current value us negative
    
    Specified by:
    
    Is_Negative in interface Number
    
    Returns:
    
    true when x <= -0
  - Is_Zero
```
public boolean Is_Zero()
```
    value is 0
    
    Specified by:
    
    Is_Zero in interface Number
    
    Returns:
    
    true when x is 0
  - Normalize
```
public void Normalize()
```
    normalize the value
    
    depending on type: remove leading zeros and / or trailing zeros
    
    Specified by:
    
    Normalize in interface Number
  - Num_Digits
```
public int Num_Digits()
               throws BCDError
```
    the current number of digits - not that when the number is not normalised there might be more 0's in the number then strictly needed.
    
    Specified by:
    
    Num_Digits in interface Number
    
    Returns:
    
    number of digits
    
    Throws:
    
    BCDError
  - P_To_X
```
@Contract(pure=true)
@NotNull
public @NotNull Number P_To_X(@NotNull
                              @NotNull Number θ)
```
    Convert Polar to Rectangle Coordinates
    
    Specified by:
    
    P_To_X in interface Number
    
    Parameters:
    
    \u03b8 - angle
    
    Returns:
    
    x = cos (w) × r
  - P_To_X
```
@Contract(pure=true)
@NotNull
public @NotNull Number P_To_X(@NotNull
                              @NotNull Number θ,
                              @NotNull
                              @NotNull Number Half_Circle)
```
    Convert Polar to Rectangle Coordinates
    
    Specified by:
    
    P_To_X in interface Number
    
    Parameters:
    
    \u03b8 - angle
    
    Half_Circle - 180 for deg, 200 for gra, pi for rad
    
    Returns:
    
    x = cos (θ) × r
  - P_To_Y
```
@Contract(pure=true)
@NotNull
public @NotNull Number P_To_Y(@NotNull
                              @NotNull Number θ)
```
    Convert Polar to Rectangle Coordinates
    
    Specified by:
    
    P_To_Y in interface Number
    
    Parameters:
    
    \u03b8 - angle
    
    Returns:
    
    y = sin (θ) × r
  - P_To_Y
```
@Contract(pure=true)
@NotNull
public @NotNull Number P_To_Y(@NotNull
                              @NotNull Number θ,
                              @NotNull
                              @NotNull Number Half_Circle)
```
    Convert Polar to Rectangle Coordinates
    
    Specified by:
    
    P_To_Y in interface Number
    
    Parameters:
    
    \u03b8 - angle
    
    Half_Circle - 180 for deg, 200 for gra, pi for rad
    
    Returns:
    
    y = sin (θ) × r
  - R_To_R
```
@Contract(pure=true)
@NotNull
public @NotNull Number R_To_R(@NotNull
                              @NotNull Number y)
```
    Convert Rectangle to Polar Coordinates
    
    Specified by:
    
    R_To_R in interface Number
    
    Parameters:
    
    y - y position
    
    Returns:
    
    r = √(x²+y²)
  - R_To_θ
```
@Contract(pure=true)
@NotNull
public @NotNull Number R_To_θ(@NotNull
                              @NotNull Number y)
```
    Convert Rectangle to Polar Coordinates
    
    Specified by:
    
    R_To_θ in interface Number
    
    Parameters:
    
    y - y position
    
    Returns:
    
    θ = arctan (y÷x)
  - R_To_θ
```
@Contract(pure=true)
@NotNull
public @NotNull Number R_To_θ(@NotNull
                              @NotNull Number y,
                              @NotNull
                              @NotNull Number Half_Circle)
```
    Convert Rectangle to Polar Coordinates
    
    Specified by:
    
    R_To_θ in interface Number
    
    Parameters:
    
    y - y position
    
    Half_Circle - 180 for deg, 200 for gra, pi for rad
    
    Returns:
    
    θ = arctan (y÷x)
  - Round
```
@NotNull
public @NotNull Number Round()
```
    Round to effective Precision and Exponent.
    
    Specified by:
    
    Round in interface Number
    
    Returns:
    
    rounded value
  - Round
```
@NotNull
public @NotNull Number Round(int Precision,
                             int Exponent)
```
    Round to a given Precision and Exponent.
    
    Specified by:
    
    Round in interface Number
    
    Parameters:
    
    Precision - Total precison
    
    Exponent - max exponent
    
    Returns:
    
    rounded value
  - To_Debug_String
```
@NotNull
public @NotNull String To_Debug_String()
```
    convert to native/debug string representation
    
    Specified by:
    
    To_Debug_String in interface Number
    
    Returns:
    
    (Coefficient, Exponent)
  - To_Integer
```
public int To_Integer()
```
    Convert to integer
    Do not mix up with Integer - This version returns a Java int!
    
    Specified by:
    
    To_Integer in interface Number
    
    Returns:
    
    value as java int
  - To_Long
```
public long To_Long()
```
    Convert to long integer
    Do not mix up with Integer - This version returns a Java int!
    
    Specified by:
    
    To_Long in interface Number
    
    Returns:
    
    value as java int
  - a
```
@NotNull
public @NotNull BCDInteger a()
```
    Fraktur represented as «a b/c»
    
    Returns:
    
    a
  - abs
```
@Contract(pure=true)
@NotNull
public @NotNull Number abs()
```
    |x|
    
    Specified by:
    
    abs in interface Number
    
    Returns:
    
    abs value
  - and
```
@Contract(pure=true)
@NotNull
public @NotNull Number and(@NotNull
                           @NotNull Number y)
```
    Logical and
    
    Specified by:
    
    and in interface Number
    
    Returns:
    
    x ∧ y
  - arc_cos
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_cos()
```
    arc cosine
    
    Specified by:
    
    arc_cos in interface Number
    
    Returns:
    
    arc cosine
  - arc_cos
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_cos(@NotNull
                               @NotNull Number Half_Circle)
```
    arc cosine
    
    Specified by:
    
    arc_cos in interface Number
    
    Parameters:
    
    Half_Circle - value for a half circle
    
    Returns:
    
    arccos (x) ÷ π × Half_Circle
  - arc_cos_hyp
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_cos_hyp()
```
    area hyperbolic cosine: log_e (x + √(x-1) × √(x+1))
    
    Specified by:
    
    arc_cos_hyp in interface Number
    
    Returns:
    
    Hyperbolic sine.
  - arc_sin
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_sin()
```
    arc sine
    
    Specified by:
    
    arc_sin in interface Number
    
    Returns:
    
    arc sine
  - arc_sin
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_sin(@NotNull
                               @NotNull Number Half_Circle)
```
    arc sine
    
    Specified by:
    
    arc_sin in interface Number
    
    Parameters:
    
    Half_Circle - value for a half circle
    
    Returns:
    
    arcsin (x) ÷ π × Half_Circle
  - arc_sin_hyp
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_sin_hyp()
```
    area hyperbolic sine: log_e (x + √(x² + 1))
    
    Specified by:
    
    arc_sin_hyp in interface Number
    
    Returns:
    
    Hyperbolic sine.
  - arc_tan
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_tan()
```
    arc tangent
    
    Specified by:
    
    arc_tan in interface Number
    
    Returns:
    
    arc tangent
  - arc_tan
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_tan(@NotNull
                               @NotNull Number Half_Circle)
```
    arc tangent
    
    Specified by:
    
    arc_tan in interface Number
    
    Parameters:
    
    Half_Circle - value for a half circle
    
    Returns:
    
    arctan (x) ÷ π × Half_Circle
  - arc_tan_hyp
```
@Contract(pure=true)
@NotNull
public @NotNull Number arc_tan_hyp()
```
    area hyperbolic tangent: log_e ((1 + x) ÷ (1 - x)) / 2
    
    Specified by:
    
    arc_tan_hyp in interface Number
    
    Returns:
    
    Hyperbolic sine.
  - b
```
@NotNull
public @NotNull BCDInteger b()
```
    Fraktur represented as «a b/c»
    
    Returns:
    
    b
  - c
```
@NotNull
public @NotNull BCDInteger c()
```
    Fraktur represented as «a b/c» or «d/c»
    
    Returns:
    
    c
  - clone
```
@NotNull
public @NotNull Object clone()
                      throws CloneNotSupportedException
```
    clone the float - but it might be easier to use the provided copy Constructor instead.
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    a new BCDInteger from an existing one.
    
    Throws:
    
    CloneNotSupportedException
    
    See Also:
    
    Object.clone()
  - compareTo
```
public int compareTo(@NotNull
                     @NotNull Number rightValue)
```
    Specified by:
    
    compareTo in interface Comparable<Number>
    
    Specified by:
    
    compareTo in interface Number
    
    Parameters:
    
    rightValue - value to compare with
    
    Returns:
    
    Compare_Equal
    
    Values are the same
    
    Compare_Less
    
    Left value less the right value
    
    Compare_Greater
    
    Left value greater the right value
    
    See Also:
    
    Comparable.compareTo(Object)
  - cos
```
@Contract(pure=true)
@NotNull
public @NotNull Number cos()
```
    cos (x)
    
    Specified by:
    
    cos in interface Number
    
    Returns:
    
    cos (x)
  - cos
```
@Contract(pure=true)
@NotNull
public @NotNull Number cos(@NotNull
                           @NotNull Number Half_Circle)
```
    cosine
    
    Specified by:
    
    cos in interface Number
    
    Parameters:
    
    Half_Circle - value for a half circle
    
    Returns:
    
    sin (x × π ÷ Half_Circle)
  - cos_hyp
```
@Contract(pure=true)
@NotNull
public @NotNull Number cos_hyp()
```
    Hyperbolic cosine: (Exponent^x + Exponent^-x)/2
    
    Specified by:
    
    cos_hyp in interface Number
    
    Returns:
    
    Hyperbolic cosine.
  - d
```
@NotNull
public @NotNull BCDInteger d()
```
    Fraktur represented as «d/c».
    
    Returns:
    
    d
  - equals
```
public boolean equals(@NotNull
                      @NotNull Object rightValue)
```
    Specified by:
    
    equals in interface Number
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    rightValue - right value
    
    Returns:
    
    true when the values are equal
  - exp_10
```
@Contract(pure=true)
@NotNull
public @NotNull Number exp_10()
                       throws BCDError
```
    10^x
    
    Specified by:
    
    exp_10 in interface Number
    
    Returns:
    
    10^x
    
    Throws:
    
    BCDError - calculation error
  - exp_e
```
@Contract(pure=true)
@NotNull
public @NotNull Number exp_e()
```
    e^x
    
    Specified by:
    
    exp_e in interface Number
    
    Returns:
    
    e^x
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - log_10
```
@Contract(pure=true)
@NotNull
public @NotNull Number log_10()
```
    log₁₀ (x)
    
    Specified by:
    
    log_10 in interface Number
    
    Returns:
    
    log₁₀ (x)
  - log_e
```
@Contract(pure=true)
@NotNull
public @NotNull Number log_e()
```
    log_e (x)
    
    Specified by:
    
    log_e in interface Number
    
    Returns:
    
    log_e (x)
  - neg
```
@Contract(pure=true)
@NotNull
public @NotNull Number neg()
```
    Specified by:
    
    neg in interface Number
    
    Returns:
    
    negative value
  - not
```
@Contract(pure=true)
@NotNull
public @NotNull Number not()
```
    Logical not
    
    Specified by:
    
    not in interface Number
    
    Returns:
    
    ¬ x
  - or
```
@Contract(pure=true)
@NotNull
public @NotNull Number or(@NotNull
                          @NotNull Number y)
```
    Logical or
    
    Specified by:
    
    or in interface Number
    
    Parameters:
    
    y - right value
    
    Returns:
    
    x ∨ y
  - root
```
@Contract(pure=true)
@NotNull
public @NotNull Number root(@NotNull
                            @NotNull Number r)
```
    ^r√x
    
    Specified by:
    
    root in interface Number
    
    Parameters:
    
    r - root
    
    Returns:
    
    e^{(log_e x ÷ r)}
  - sin
```
@Contract(pure=true)
@NotNull
public @NotNull Number sin()
```
    sine
    
    Specified by:
    
    sin in interface Number
    
    Returns:
    
    sin (x)
  - sin
```
@Contract(pure=true)
@NotNull
public @NotNull Number sin(@NotNull
                           @NotNull Number Half_Circle)
```
    sine
    
    Specified by:
    
    sin in interface Number
    
    Parameters:
    
    Half_Circle - value for a half circle
    
    Returns:
    
    sin (x × π ÷ Half_Circle)
  - sin_hyp
```
@Contract(pure=true)
@NotNull
public @NotNull Number sin_hyp()
```
    hyperbolic sine: (e^x - e^-x) ÷ 2
    
    Specified by:
    
    sin_hyp in interface Number
    
    Returns:
    
    Hyperbolic sine.
  - square
```
@Contract(pure=true)
@NotNull
public @NotNull Number square()
```
    x²
    
    Specified by:
    
    square in interface Number
    
    Returns:
    
    x²
  - square_root
```
@Contract(pure=true)
@NotNull
public @NotNull Number square_root()
```
    ²√x
    
    Specified by:
    
    square_root in interface Number
    
    Returns:
    
    ²√x
  - tan
```
@Contract(pure=true)
@NotNull
public @NotNull Number tan()
```
    tan x
    
    Specified by:
    
    tan in interface Number
    
    Returns:
    
    tan (x × π ÷ Half_Circle)
  - tan
```
@Contract(pure=true)
@NotNull
public @NotNull Number tan(@NotNull
                           @NotNull Number Half_Circle)
```
    tangent
    
    Specified by:
    
    tan in interface Number
    
    Parameters:
    
    Half_Circle - value for a half circle
    
    Returns:
    
    tangent
  - tan_hyp
```
@NotNull
public @NotNull Number tan_hyp()
```
    Hyperbolic tangent: (e^2x - 1) ÷ (e^2x + 1)
    
    Specified by:
    
    tan_hyp in interface Number
    
    Returns:
    
    Hyperbolic tangent.
  - toString
```
@NotNull
public @NotNull String toString()
```
    display as debug string
    
    Specified by:
    
    toString in interface Number
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    string representation
    
    See Also:
    
    Object.toString()
  - xor
```
@Contract(pure=true)
@NotNull
public @NotNull Number xor(@NotNull
                           @NotNull Number y)
```
    Logical xor
    
    Specified by:
    
    xor in interface Number
    
    Returns:
    
    x ⊻ y

Class BCDFraction

Field Summary

Fields inherited from interface net.sourceforge.uiq3.math.Number

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface net.sourceforge.uiq3.math.Number

Field Detail

Logger

TAG

Values_2

Values_3

Approx_e

Approx_π

Num_0

Num_1

Num_180

Num_2

Num_200

Denominator

Numerator

Constructor Detail

BCDFraction

BCDFraction

BCDFraction

BCDFraction

BCDFraction

BCDFraction

BCDFraction

Method Detail

$div

$minus

$plus

$times

$times$times

As_BCDFloat

As_BCDFraction

As_BCDInteger

Clone

Coefficient_As_Long

Compare

Digits

Exponent

Fix

Frac

Indirect_Value

Integer

Is_Finite

Is_Infinite

Is_Integer

Is_NaN

Is_Negative

Is_Zero

Normalize

Num_Digits

P_To_X

P_To_X

P_To_Y

P_To_Y

R_To_R

R_To_θ

R_To_θ

Round

Round

To_Debug_String

To_Integer

To_Long

a

abs

and

arc_cos

arc_cos

arc_cos_hyp

arc_sin

arc_sin

arc_sin_hyp

arc_tan

arc_tan

arc_tan_hyp

b