Crate gmp_mpfr_sys [−] [src]
Rust low-level bindings for GMP, MPFR and MPC
The gmp-mpfr-sys
crate provides Rust low-level bindings for
- the GNU Multiple Precision Arithmetic Library (GMP),
- the GNU MPFR Library, a library for multiple-precision floating-point computations, and
- GNU MPC, a library for the arithmetic of complex numbers with arbitrarily high precision.
This crate is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This crate provides a low-level interface to GMP, MPFR and MPC. If you want a high-level API, consider using the following crates:
rugint
provides arbitrary-precision integers based on GMP.rugrat
provides arbitrary-precision rational number based on GMP.rugflo
provides arbitrary-precision floating-point numbers based on MPFR.rugcom
provides arbitrary-precision complex numbers based on MPC.
If you want to use the low-level bindings, you can refer to the documentation of the C libraries themselves:
Notes
Name prefixes
Since modules and enumerated types provide namespacing, most
prefixes in the C names are removed. However, when the prefix is
not a whole word it is not removed, for example
mp_set_memory_functions()
becomes gmp::set_memory_functions()
,
but mpz_init()
becomes gmp::mpz_init()
not gmp::z_init()
,
and MPFR_RNDN
in enum MPFR_RND_T
becomes mpfr::rnd_t::RNDN
not mpfr::rnd_t::N
. Also, the types mpfr::mpfr_t
and
mpc::mpc_t
are not shortened to mpfr::t
or mpc::t
.
Types
Unlike in the C libraries, the types gmp::mpz_t
, gmp::mpq_t
,
gmp::mpf_t
, gmp::rand_state_t
, mpfr::mpfr_t
and mpc::mpc_t
are defined directly as structs, not as single-element arrays.
Undocumented or obsolete functions
The bindings do not cover undocumented or obsolete functions and macros.
Usage
To use gmp-mpfr-sys
in your crate, add
extern crate gmp_mpfr_sys;
to the crate root and add
gmp-mpfr-sys
as a dependency in Cargo.toml
:
[dependencies]
gmp-mpfr-sys = "0.5.1"
Building on GNU/Linux
To build on GNU/Linux, simply make sure you have diffutils
, gcc
and make
installed on your system. For example on Fedora:
sudo dnf install diffutils gcc make
Building on macOS
To build on macOS, you need the command-line developer tools. An easy
way to install them is to start building the crate using
cargo build
. If the tools are not installed yet, a popup should
appear which should help you install them.
Building on Windows
You can build on Windows with the Rust GNU toolchain and an up-to-date MSYS2 installation. Some steps for a 64-bit environment are listed below, you can follow similar steps for a 32-bit environment by substituting 32 for 64. To install MSYS2:
Install MSYS2 using the installer.
Launch the MSYS2 MinGW 64-bit terminal from the start menu.
Install the required tools.
sh pacman -S pacman-mirrors pacman -S diffutils make mingw-w64-x86_64-gcc
Then, to build a crate with a dependency on this crate:
Launch the MSYS MinGW 64-bit terminal from the start menu.
Change to the crate directory.
Note that building the GMP and MPFR libraries in MSYS with absolute paths does not work very well, so relative paths are used. If your crate is inside
C:\msys64
and the.cargo
directory is outsideC:\msys64
, this will not work. Please move your crate to the same side ofC:\msys64
as.cargo
.Build the crate using
cargo
.
Modules
gmp | |
mpc | |
mpfr |