aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: ce2ad09ecf9e364f1d473fc283e2d5ea381eefee (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
NAME
	libzahl - big integer library

ETYMOLOGY
	The bold uppercase Z which represents the set of
	all integers is derived from the german word 'zahlen',
	whose singular is 'zahl'.

DESCRIPTION
	libzahl is a C library for arbitrary size integers,
	that aims to be usable for rubust programs, and be
	fast.

	libzahl will accomplish this by using long jumps
	when an error is detected, rather than letting the
	caller also perform a check. This shall make the
	code in the user program cleaner too. libzahl will
	use dedicated temporary bitnum integers whether
	possible, and necessary, for its internal calculations.
	libzahl will not deallocate allocations, but rather
	cache them for reuse.

	With the exception of functions working with strings,
	all output parameters are before the input parameters.

RATIONALE
	GMP MP cannot be used for rubust programs. LibTomMath
	is too slow, probably because of all memory allocations,
	and has an nonintuitive API. Hebimath is promising, but
	I think it can be done better.