Julia wrapper around GMP's rational type
2 Stars
Updated Last
1 Year Ago
Started In
July 2020


Build Status Build Status codecov Aqua QA

This package provides a wrapper around the GNU Multiple Precision (GMP) rational type mpq_t into the new Julia type BigRational. It requires GMP to be installed. For interoperability with Julia's native BigInt type (which is a wrapper around GMP's integer type mpz_t), the same version of GMP should be used for both Julia and this package. This package is not tested for systems where the default GMP installation version is not the same as Julia's.

GMP functions for rationals are wrapped in the MPQ module, similar to Base.GMP.MPZ. For instance, to use faster in-place operations, one may do:

julia> using BigRationals

julia> x = BigRational(3,4)

julia> BigRationals.MPQ.add!(x, BigRational(2,3))

julia> x

The BigRational type can also be used with the full interface of the native Rational type, including the numerator and denominator functions, comparisons (==, <=, etc.), arithmetic (+, -, *, /, etc.) and others. It is also defined as a subtype of Real and can be used as such.

BigRational aims to be a faster replacement for Rational{BigInt}. However, both types coexist when using this package and Rational{BigInt} can still be used as before. Conversion between the two types is as simple as:

julia> x = BigRational(3,4)

julia> y = Rational(x)

julia> typeof(y)

julia> BigRational(y)

Be warned that, even with this package, widen(Rational{Int128}) == Rational{BigInt} and big(Rational) == Rational{BigInt} and not BigRational, since changing these behaviours would be type piracy.