#rational #ratio #fraction #fractions

rational

Minimalistic library for rational numbers

7 releases (2 stable)

1.1.0 Jan 4, 2023
1.0.0 Aug 16, 2021
0.3.0 Aug 10, 2021
0.2.3 Jul 10, 2021
0.1.1 Apr 29, 2021

#172 in Math

Download history 1/week @ 2022-11-22 2/week @ 2022-11-29 1/week @ 2022-12-06 7/week @ 2022-12-13 1/week @ 2022-12-20 1/week @ 2022-12-27 32/week @ 2023-01-03 3/week @ 2023-01-10 8/week @ 2023-01-17 8/week @ 2023-01-24 14/week @ 2023-01-31 46/week @ 2023-02-07 38/week @ 2023-02-14 10/week @ 2023-02-21 2/week @ 2023-02-28

57 downloads per month

MIT license

41KB
950 lines

A minimal library for representing rational numbers (ratios of integers).

Example

// all rationals are automatically reduced when created, so equality works as following:
let one_half = Rational::new(1, 2);
let two_quarters = Rational::new(2, 4);
assert_eq!(one_half, two_quarters);

// you can make more complicated rationals:
let one_half_over_one_quarter = Rational::new(Rational::new(1, 2), Rational::new(1, 4)); // (1/2)/(1/4)
assert_eq!(one_half_over_one_quarter, Rational::new(2, 1));

// mathematical operations are implemented for integers and rationals:
let one_ninth = Rational::new(1, 9);
assert_eq!(one_ninth + Rational::new(5, 4), Rational::new(49, 36));
assert_eq!(one_ninth - 4, Rational::new(-35, 9));
assert_eq!(one_ninth / Rational::new(21, 6), Rational::new(2, 63));

// other properties, such as
// inverse
let r = Rational::new(8, 3);
let inverse = r.inverse();
assert_eq!(inverse, Rational::new(3, 8));
assert_eq!(inverse, Rational::new(1, r));
// mixed fraction
let (whole, fractional) = r.mixed_fraction();
assert_eq!(whole, 2);
assert_eq!(fractional, Rational::new(2, 3));

No runtime deps