This is an optional module. It is only available when Python is configured to include it, which requires that the GNU MP software is installed.
This module implements the interface to part of the GNU MP library, which defines arbitrary precision integer and rational number arithmetic routines. Only the interfaces to the integer (mpz_*()) routines are provided. If not stated otherwise, the description in the GNU MP documentation can be applied.
In general, mpz-numbers can be used just like other standard Python numbers, e.g. you can use the built-in operators like +, *, etc., as well as the standard built-in functions like abs(), int(), ..., divmod(), pow(). Please note: the bitwise-xor operation has been implemented as a bunch of ands, inverts and ors, because the library lacks an mpz_xor() function, and I didn't need one.
You create an mpz-number by calling the function mpz() (see below for an exact description). An mpz-number is printed like this: mpz(value).
A number of extra functions are defined in this module. Non mpz-arguments are converted to mpz-values first, and the functions return mpz-numbers.
An mpz-number has one method:
The mpz-number must have a value greater than or equal to zero, otherwise ValueError will be raised.