Ralf Peine > Math-GoldenBigMath-0-800 > Math::GoldenBigMath
Module Version: 0.800

# NAME

Math::GoldenBigMath - Verified Big Real Number Calcualtion With Operators + - * / %

# VERSION

This documentation refers to version 0.800 of Math::GoldenBigMath

# SYNOPSIS

```  use Math::GoldenBigMath;

\$a = new Math::GoldenBigMath("3");
\$b = new Math::GoldenBigMath("4.1e+0");

\$sum  = \$a + \$b;      #  7.1   "+71e-1"
\$diff = \$a - \$b;      # -1.1   "-11e-1"
\$mul  = \$a * \$b;      # 12.3   "+123e-1"

print "\$a + \$b = \$sum\n";
print "\$a - \$b = \$diff\n";
print "\$a * \$b = \$mul\n";

\$a->Simplify(); # get back to optimal exponent

print "\$a\n";

print '3 <=> 4.1: '.(\$a <=> \$b)."\n";
print '3 >  4.1:  '.(\$a >  \$b)."\n";
print '3 >= 4.1:  '.(\$a >= \$b)."\n";
print '3 <  4.1:  '.(\$a <  \$b)."\n";
print '3 <= 4.1:  '.(\$a <= \$b)."\n";
print '3 == 4.1:  '.(\$a == \$b)."\n";
print '3 == 3:    '.(\$a == \$a)."\n";```

# DESCRIPTION

This class implements the algorithms I (and all other german childrens) learned in my school, in german called "Schriftliches Rechnen". That means exact calculation with pencil and paper, before computers or electronical calculators come up.

All of these alogrithms are exact, simple, well known and mathematical completely proven. But they are not very fast, even for computers.

So GoldenBigMath can be used for calculation, if high speed is not necessary or you have time to wait for the results.

It was designed to be used as a golden device to check all the other existing libraries handling big numbers, which are fast and complicated and so can contain errors.

Later on GoldenBigMath shell be proved by many other developers to get a verification of correctness in that sense, if you get a result, that the result is correct. But there is still the possibility not to get a result, because of programming problems, memory problems or you can't wait several years for the algorithm to finsh calculation...

## Missing!

More description will follow...

# Known Bugs / Missing Features

Division is not possible yet but will come in this year (I hope to have time for it...)

# USAGE

Create one or more GoldenBigMath and use operators for calculation:

`  + - * / % `

or comparison:

`  <=> < <= > >= == !=`

## Missing!

More description will follow... See SYNOPSIS

# AUTHOR

Ralf Peine, ralf.peine@jupiter-programs.de