Trait num::integer::Integer
[-] [+]
[src]
pub trait Integer: Sized + Num + PartialOrd + Ord + Eq {
fn div_floor(&self, other: &Self) -> Self;
fn mod_floor(&self, other: &Self) -> Self;
fn gcd(&self, other: &Self) -> Self;
fn lcm(&self, other: &Self) -> Self;
fn divides(&self, other: &Self) -> bool;
fn is_multiple_of(&self, other: &Self) -> bool;
fn is_even(&self) -> bool;
fn is_odd(&self) -> bool;
fn div_rem(&self, other: &Self) -> (Self, Self);
fn div_mod_floor(&self, other: &Self) -> (Self, Self) { ... }
}
Required Methods
fn div_floor(&self, other: &Self) -> Self
Floored integer division.
Examples
extern crate num; fn main() { use num::Integer; assert!(( 8).div_floor(& 3) == 2); assert!(( 8).div_floor(&-3) == -3); assert!((-8).div_floor(& 3) == -3); assert!((-8).div_floor(&-3) == 2); assert!(( 1).div_floor(& 2) == 0); assert!(( 1).div_floor(&-2) == -1); assert!((-1).div_floor(& 2) == -1); assert!((-1).div_floor(&-2) == 0); }assert!(( 8).div_floor(& 3) == 2); assert!(( 8).div_floor(&-3) == -3); assert!((-8).div_floor(& 3) == -3); assert!((-8).div_floor(&-3) == 2); assert!(( 1).div_floor(& 2) == 0); assert!(( 1).div_floor(&-2) == -1); assert!((-1).div_floor(& 2) == -1); assert!((-1).div_floor(&-2) == 0);
fn mod_floor(&self, other: &Self) -> Self
Floored integer modulo, satisfying:
extern crate num; fn main() { use num::Integer; let n = 1; let d = 1; assert!(n.div_floor(&d) * d + n.mod_floor(&d) == n) }assert!(n.div_floor(&d) * d + n.mod_floor(&d) == n)
Examples
extern crate num; fn main() { use num::Integer; assert!(( 8).mod_floor(& 3) == 2); assert!(( 8).mod_floor(&-3) == -1); assert!((-8).mod_floor(& 3) == 1); assert!((-8).mod_floor(&-3) == -2); assert!(( 1).mod_floor(& 2) == 1); assert!(( 1).mod_floor(&-2) == -1); assert!((-1).mod_floor(& 2) == 1); assert!((-1).mod_floor(&-2) == -1); }assert!(( 8).mod_floor(& 3) == 2); assert!(( 8).mod_floor(&-3) == -1); assert!((-8).mod_floor(& 3) == 1); assert!((-8).mod_floor(&-3) == -2); assert!(( 1).mod_floor(& 2) == 1); assert!(( 1).mod_floor(&-2) == -1); assert!((-1).mod_floor(& 2) == 1); assert!((-1).mod_floor(&-2) == -1);
fn gcd(&self, other: &Self) -> Self
Greatest Common Divisor (GCD).
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(6.gcd(&8), 2); assert_eq!(7.gcd(&3), 1); }assert_eq!(6.gcd(&8), 2); assert_eq!(7.gcd(&3), 1);
fn lcm(&self, other: &Self) -> Self
Lowest Common Multiple (LCM).
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(7.lcm(&3), 21); assert_eq!(2.lcm(&4), 4); }assert_eq!(7.lcm(&3), 21); assert_eq!(2.lcm(&4), 4);
fn divides(&self, other: &Self) -> bool
Deprecated, use is_multiple_of instead.
fn is_multiple_of(&self, other: &Self) -> bool
Returns true if other is a multiple of self.
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(9.is_multiple_of(&3), true); assert_eq!(3.is_multiple_of(&9), false); }assert_eq!(9.is_multiple_of(&3), true); assert_eq!(3.is_multiple_of(&9), false);
fn is_even(&self) -> bool
Returns true if the number is even.
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(3.is_even(), false); assert_eq!(4.is_even(), true); }assert_eq!(3.is_even(), false); assert_eq!(4.is_even(), true);
fn is_odd(&self) -> bool
Returns true if the number is odd.
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(3.is_odd(), true); assert_eq!(4.is_odd(), false); }assert_eq!(3.is_odd(), true); assert_eq!(4.is_odd(), false);
fn div_rem(&self, other: &Self) -> (Self, Self)
Simultaneous truncated integer division and modulus.
Returns (quotient, remainder).
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(( 8).div_rem( &3), ( 2, 2)); assert_eq!(( 8).div_rem(&-3), (-2, 2)); assert_eq!((-8).div_rem( &3), (-2, -2)); assert_eq!((-8).div_rem(&-3), ( 2, -2)); assert_eq!(( 1).div_rem( &2), ( 0, 1)); assert_eq!(( 1).div_rem(&-2), ( 0, 1)); assert_eq!((-1).div_rem( &2), ( 0, -1)); assert_eq!((-1).div_rem(&-2), ( 0, -1)); }assert_eq!(( 8).div_rem( &3), ( 2, 2)); assert_eq!(( 8).div_rem(&-3), (-2, 2)); assert_eq!((-8).div_rem( &3), (-2, -2)); assert_eq!((-8).div_rem(&-3), ( 2, -2)); assert_eq!(( 1).div_rem( &2), ( 0, 1)); assert_eq!(( 1).div_rem(&-2), ( 0, 1)); assert_eq!((-1).div_rem( &2), ( 0, -1)); assert_eq!((-1).div_rem(&-2), ( 0, -1));
Provided Methods
fn div_mod_floor(&self, other: &Self) -> (Self, Self)
Simultaneous floored integer division and modulus.
Returns (quotient, remainder).
Examples
extern crate num; fn main() { use num::Integer; assert_eq!(( 8).div_mod_floor( &3), ( 2, 2)); assert_eq!(( 8).div_mod_floor(&-3), (-3, -1)); assert_eq!((-8).div_mod_floor( &3), (-3, 1)); assert_eq!((-8).div_mod_floor(&-3), ( 2, -2)); assert_eq!(( 1).div_mod_floor( &2), ( 0, 1)); assert_eq!(( 1).div_mod_floor(&-2), (-1, -1)); assert_eq!((-1).div_mod_floor( &2), (-1, 1)); assert_eq!((-1).div_mod_floor(&-2), ( 0, -1)); }assert_eq!(( 8).div_mod_floor( &3), ( 2, 2)); assert_eq!(( 8).div_mod_floor(&-3), (-3, -1)); assert_eq!((-8).div_mod_floor( &3), (-3, 1)); assert_eq!((-8).div_mod_floor(&-3), ( 2, -2)); assert_eq!(( 1).div_mod_floor( &2), ( 0, 1)); assert_eq!(( 1).div_mod_floor(&-2), (-1, -1)); assert_eq!((-1).div_mod_floor( &2), (-1, 1)); assert_eq!((-1).div_mod_floor(&-2), ( 0, -1));