ocaml/otherlibs/num
Damien Doligez d77533abfa On utilise Sys.get_config au lieu de cpp.
git-svn-id: http://caml.inria.fr/svn/ocaml/trunk@1055 f963ae5c-01c2-4b8c-9fe0-0dff7051ff02
1996-10-07 14:03:20 +00:00
..
bignum Portage NT. 1996-02-22 12:52:45 +00:00
test MAJ des dependances. MAJ de ocamlcp. 1996-05-11 18:26:49 +00:00
.cvsignore - 1996-05-04 14:39:41 +00:00
.depend MAJ des dependances. MAJ de ocamlcp. 1996-05-11 18:26:49 +00:00
.depend.nt Dependences pour NT. 1996-03-18 12:07:56 +00:00
Makefile On utilise Sys.get_config au lieu de cpp. 1996-10-07 14:03:20 +00:00
Makefile.nt On utilise Sys.get_config au lieu de cpp. 1996-10-07 14:03:20 +00:00
README Portage de libnum pour Caml Special Light 1995-11-06 10:34:19 +00:00
arith_flags.ml Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
arith_flags.mli Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
arith_status.ml Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
arith_status.mli Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
big_int.ml Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
big_int.mli Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
int_misc.ml On utilise Sys.get_config au lieu de cpp. 1996-10-07 14:03:20 +00:00
int_misc.mli Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
nat.h Oubli 1995-11-06 13:09:04 +00:00
nat.ml On utilise Sys.get_config au lieu de cpp. 1996-10-07 14:03:20 +00:00
nat.mli Implementer length_nat par %obj_size au lieu de %array_length, qui 1996-09-23 11:31:32 +00:00
nat_stubs.c Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
num.ml Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
num.mli Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
ratio.ml Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
ratio.mli Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
string_misc.ml Renommage en Objective Caml 1996-04-30 14:53:58 +00:00
string_misc.mli Renommage en Objective Caml 1996-04-30 14:53:58 +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

        cslc -custom <other options> nums.cma <other .cmo and .ml files> -lnums

for the linking phase.

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

        cslmktop -o csltopnum -custom <other options> nums.cma <other .cmo and .ml files> -lnums
        ./csltopnum

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.