C++ Big Integer Library
(see ChangeLog for version)
- http://www.kepreon.com/~matt/bigint/
+ http://mattmccutchen.net/bigint/
- Written and maintained by Matt McCutchen <hashproduct@gmail.com>
+ Written and maintained by Matt McCutchen <matt@mattmccutchen.net>
You can use this library in a C++ program to do arithmetic on integers of size
limited only by your computer's memory. The library provides BigUnsigned and
The code in `sample.cc' demonstrates the most important features of the library.
To get started quickly, read the code and explanations in that file and run it.
If you want more detail or a feature not shown in `sample.cc', consult the
-consult the actual header and source files, which are heavily commented.
+consult the actual header and source files, which are thoroughly commented.
+
+This library emphasizes ease of use and clarity of implementation over speed;
+some users will prefer GMP (http://swox.com/gmp/), which is faster. The code is
+intended to be reasonably portable across computers and modern C++ compilers; in
+particular, it uses whatever word size the computer provides (32-bit, 64-bit, or
+otherwise).
Compiling programs that use the library
---------------------------------------
files (`.cc'). `#include' header files and compile with source files as
necessary for your own programs. A Makefile is included that compiles the
library source files and the sample program and links them together; you can
-easily customize the Makefile to replace the sample with your own program, or
-you can write your own Makefile.
+easily customize the Makefile to replace the sample with your own program or use
+your own Makefile or IDE.
+
+NOTE: It is generally useless to ask me how to set up the library in your IDE
+because you know more about the IDE than I do (unless it's the Eclipse CDT
+<http://www.eclipse.org/cdt/>).
+
+Resources
+---------
+The library's Web site (above) provides links to released versions, the current
+development version, and a mailing list for release announcements, questions,
+bug reports, and other discussion of the library. I would be delighted to hear
+from you if you like this library and/or find a good use for it.
Bugs and enhancements
---------------------
The library has been tested by me and others but is by no means bug-free. If
-you find a bug, please report it to me, whether it comes in the form of
-compiling trouble, a mathematically inaccurate result, or a memory-management
-blooper (since I use Java, these are altogether too common in my C++). I
-generally fix all reported bugs.
-
-You are also welcome to request enhancements, but I am unlikely to do
-substantial amounts of work on enhancements at this point. When I fix a bug you
-report or make an enhancement you request, I will generally credit you by name
-in the source code and/or the Change Log unless you request otherwise. New
-versions of the library will be available at its Web site (above).
-
-Note
-----
-I would be delighted to hear from you if you like this library and/or find a
-good use for it.
+you find a bug, please report it, whether it comes in the form of compiling
+trouble, a mathematically inaccurate result, or a memory-management blooper
+(since I use Java, these are altogether too common in my C++). I generally fix
+all reported bugs. You are also welcome to request enhancements, but I am
+unlikely to do substantial amounts of work on enhancements at this point.
Legal
-----