Ralf Peine > Math-GoldenBigMath-0 > Math::GoldenBigMath

Download:
Math-GoldenBigMath-0-800.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.800   Source  

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

LICENSE AND COPYRIGHT ^

Copyright (c) 2011-2013 by Ralf Peine. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6.0 or, at your option, any later version of Perl 5 you may have available.

DISCLAIMER OF WARRANTY ^

This library is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

syntax highlighting: