ocaml/otherlibs/num
Xavier Leroy b070d1dce0 MAJ portage Win32
git-svn-id: http://caml.inria.fr/svn/ocaml/trunk@2962 f963ae5c-01c2-4b8c-9fe0-0dff7051ff02
2000-03-16 13:35:20 +00:00
..
bignum MacOS 2000-03-01 13:01:44 +00:00
test Introduction des blocs de type Custom. 2000-02-10 14:04:59 +00:00
.cvsignore do not ignore .ml anymore 1999-03-30 06:12:39 +00:00
.depend Ajout des modules Int32, Int64 et Nativeint 2000-02-11 15:09:27 +00:00
.depend.nt Dependences pour NT. 1996-03-18 12:07:56 +00:00
Makefile Nouveau format de .cma et .cmxa, se rappelle des -cclib et -ccopt necessaires pour le link final 2000-03-09 09:12:28 +00:00
Makefile.Mac MacOS 2000-03-01 13:01:44 +00:00
Makefile.Mac.depend MacOS 2000-03-01 13:01:44 +00:00
Makefile.nt MAJ portage Win32 2000-03-16 13:35:20 +00:00
README fix -lnums -> -cclib -lnums 1997-10-14 13:29:43 +00:00
arith_flags.ml Changement de la licence 1999-11-17 18:59:06 +00:00
arith_flags.mli Changement de la licence 1999-11-17 18:59:06 +00:00
arith_status.ml Changement de la licence 1999-11-17 18:59:06 +00:00
arith_status.mli Changement de la licence 1999-11-17 18:59:06 +00:00
big_int.ml Changement de la licence 1999-11-17 18:59:06 +00:00
big_int.mli Changement de la licence 1999-11-17 18:59:06 +00:00
int_misc.ml Changement de la licence 1999-11-17 18:59:06 +00:00
int_misc.mli Changement de la licence 1999-11-17 18:59:06 +00:00
nat.h Introduction des blocs de type Custom. 2000-02-10 14:04:59 +00:00
nat.ml Introduction des blocs de type Custom. 2000-02-10 14:04:59 +00:00
nat.mli Introduction des blocs de type Custom. 2000-02-10 14:04:59 +00:00
nat_stubs.c Introduction des blocs de type Custom. 2000-02-10 14:04:59 +00:00
num.ml Revues add_num mult_num et div_num pour la normalisation des rationnels. 2000-03-01 16:46:30 +00:00
num.mli Changement de la licence 1999-11-17 18:59:06 +00:00
ratio.ml Changement de la licence 1999-11-17 18:59:06 +00:00
ratio.mli Changement de la licence 1999-11-17 18:59:06 +00:00
string_misc.ml Changement de la licence 1999-11-17 18:59:06 +00:00
string_misc.mli Changement de la licence 1999-11-17 18:59:06 +00:00

README

The "libnum" library implements exact-precision rational arithmetic.
It is built upon the state-of-the-art BigNum arbitrary-precision
integer arithmetic package, and therefore achieves very high
performance (it's faster than Maple, for instance).

This library is derived from Valerie Menissie-Morain's implementation
of rational arithmetic for Caml V3.1 (INRIA), and builds on the BigNum
package developed by Bernard Serpette, Jean Vuillemin and Jean-Claude
Herve (INRIA and Digital PRL). Xavier Leroy (INRIA) did the Caml Light
port. Victor Manuel Gulias Fernandez did the Caml Special Light port.

This library is documented in "The CAML Numbers Reference Manual" by 
Valerie Menissier-Morain, technical report 141, INRIA, july 1992,
available by anonymous FTP from ftp.inria.fr, directory
INRIA/publications/RT, file RT-0141.ps.Z.

USAGE:

To use the bignum library from your programs, just do

    ocamlc -custom <options> nums.cma <.cmo and .ml files> -cclib -lnums

for the linking phase.

If you'd like to have the bignum functions available at toplevel, do

    ocamlmktop -o ocamltopnum -custom <options> nums.cma <.cmo and .ml files> -cclib -lnums
    ./ocamltopnum

As an example, try:

        open Num;;
        let rec fact n =
          if n = 0 then Int 1 else mult_num (num_of_int n) (fact(n-1));;
        string_of_num(fact 1000);;

KNOWN TARGET ARCHITECTURES:

        C               portable C version (default)
        sparc           Sparc V8 assembly code, SunOS 4.1
        sparc-solaris   Sparc V8 assembly code, Solaris 2
        supersparc      Sparc V9 assembly code, SunOS 4.1
        supersparc-solaris Sparc V9 assembly code, Solaris 2
        mips            MIPS R2000, R3000, R4000 assembly code
        alpha           DEC Alpha (21064) assembly code
        68K             Motorola 68020 assembly code
        vax             DEC VAX assembly code
        i960            Intel 80960A assembly code
        ns              National Semiconductors 32032 assembly code
        pyramid         Pyramid minicomputers assembly code

LEGAL NOTICE:

This work uses the BigNum package developed jointly by INRIA and Digital PRL.

The code in the bignum/ subdirectory is copyright INRIA and Digital,
and may be reproduced and distributed freely to non commercial usage
according to the conditions stated in the documentation of this package
(directory bignum/doc).

KNOWN PROBLEMS:

64-bit architectures are not yet fully supported.  The test suite passes on 
a Dec Alpha, but some bugs remain.