Apa v0.6.0 Apa View Source
APA : Arbitrary Precision Arithmetic - pure Elixir implementation.
For arbitrary precision mathematics - which supports numbers of any size and precision up to nearly unlimited of decimals (internal Elixir integer math), represented as strings. This is especially useful when working with floating-point numbers, as these introduce small but in some case significant rounding errors. Inspired by BCMath/PHP. I started this project to learn for myself - so the focus was on learning and have fun! You could use it if you like - there are some test coverage - but for production I would recomend the Decimal (https://github.com/ericmj/decimal) package!
The 'precision' of a ApaNumber is the total count of significant digits in the whole number, that is, the number of digits to both sides of the decimal point. The 'scale' of a ApaNumber is the count of decimal digits in the fractional part, to the right of the decimal point
You are welcome to read the code and if you find something that could be done better, please let me know.
Link to this section Summary
Functions
APA : Arbitrary Precision Arithmetic - Addition
APA : Arbitrary Precision Arithmetic - Homage to Douglas Adams
APA : Arbitrary Precision Arithmetic - Comparison - ApaComp
APA : Arbitrary Precision Arithmetic - Division
APA : Arbitrary Precision Arithmetic - Multiplication
APA : Arbitrary Precision Arithmetic - Subtraction
Link to this section Functions
APA : Arbitrary Precision Arithmetic - Addition
Examples
iex> Apa.add("1", "2") "3"
iex> Apa.add("1", "-2") "-1"
iex> Apa.add("-1", "2") "1"
iex> Apa.add("-1", "-2") "-3"
iex> Apa.add("999989", "222222") "1222211"
iex> Apa.add("222222", "999989") "1222211"
iex> Apa.add("999", "999989") "1000988"
iex> Apa.add("000000999", "0999989") "1000988"
iex> "1" |> Apa.add("2") |> Apa.add("3.3") |> Apa.add("-3") "3.3"
Compared to standard Elixir - wrong value 6.6! iex> 3.30000000000000004 + 3.30000000000000003 6.6
Correct with APA: iex> Apa.add("3.30000000000000004", "3.30000000000000003") "6.60000000000000007"
iex> Apa.add("3.304","3.300003") "6.604003"
iex> Apa.add("-3.304","-3.300003") "-6.604003"
iex> Apa.add("-3.304","3.300003") "-0.003997"
iex> Apa.add("3.304","-3.300003") "0.003997"
iex> Apa.add("3","3.303") "6.303"
iex> Apa.add("3.303","3") "6.303"
iex> Apa.add("3.303","+003") "6.303"
iex> Apa.add("1","+00120.000") "121"
iex> Apa.add("1.0e2", "1.1") "101.1"
APA : Arbitrary Precision Arithmetic - Homage to Douglas Adams
The Answer to the Ultimate Question of Life, the Universe, and Everything
Examples
iex> Apa.answer("Ultimate Question of Life, the Universe, and Everything") "42"
iex> Apa.answer("Das Leben, das Universum und der ganze Rest") "42"
iex> Apa.answer("six by nine") "forty two"
APA : Arbitrary Precision Arithmetic - Comparison - ApaComp
Compares the left_operand to the right_operand and returns the result as an integer.
left - the left operand, as a string. right - the right operand, as a string. TODO: precision, scale scale - the optional scale parameter is used to set the number of digits after the decimal place which will be used in the comparison.
Returns: 0 if the two operands are equal, 1 if the left_operand is larger than the right_operand, -1 otherwise.
Examples
iex> Apa.comp("9", "3") 1
iex> Apa.comp("3", "9") -1
iex> Apa.comp("999999999999999999999999999","999999999999999999999999999") 0
iex> Apa.comp("0","0") 0
iex> Apa.comp("+0","-0") 0
iex> Apa.comp("-0","-0") 0
iex> Apa.comp("+1","-1") 1
iex> Apa.comp("1.0","1.0") 0
iex> Apa.comp("-1","-1.0") 0
Compared to standard Elixir this is fixed with APA - it is -1 !!! iex> Apa.comp("12","12.0000000000000001") -1
Compared to standard Elixir this is fixed with APA - it is 1 !!! iex> Apa.comp("3.30000000000000004", "3.30000000000000003") 1
iex> Apa.comp("1.1", "1.0") 1
iex> Apa.comp("1.0", "1.1") -1
iex> Apa.comp("1.0", "1.1", 0, 1) -1
iex> Apa.comp("1.0", "1.1", 0, 0) 0
APA : Arbitrary Precision Arithmetic - Division
Examples
iex> Apa.div("6", "2") "3"
iex> Apa.div("6", "3") "2"
iex> Apa.div("6", "-3") "-2"
iex> Apa.div("-6", "3") "-2"
iex> Apa.div("-6", "-3") "2"
iex> "18" |> Apa.div("2") |> Apa.div("3") "3"
iex> Apa.div("222.2001", "2222.001") "0.1"
APA : Arbitrary Precision Arithmetic - Multiplication
Examples
iex> Apa.mul("3", "2") "6"
iex> Apa.mul("2", "3") "6"
iex> Apa.mul("2", "-3") "-6"
iex> Apa.mul("-2", "3") "-6"
iex> Apa.mul("-2", "-3") "6"
iex> "1" |> Apa.mul("2") |> Apa.mul("3") "6"
APA : Arbitrary Precision Arithmetic - Subtraction
Examples
iex> Apa.sub("3", "2") "1"
iex> Apa.sub("2", "3") "-1"
iex> Apa.sub("2", "+3") "-1"
iex> Apa.sub("2", "-3") "5"
iex> Apa.sub("-2", "3") "-5"
iex> "1" |> Apa.sub("2") |> Apa.add("3.30") |> Apa.sub("2.40") "-0.1"
Compared to standard Elixir - wrong value 0.0! iex> 3.30000000000000004 - 3.30000000000000003 0.0
this is fixed with APA: iex> Apa.sub("3.30000000000000004", "3.30000000000000003") "0.00000000000000001"