# [−][src]Struct num_rational::Ratio

`pub struct Ratio<T> { /* fields omitted */ }`

Represents the ratio between two numbers.

## Implementations

### `impl<T> Ratio<T>`[src]

These method are `const` for Rust 1.31 and later.

#### `pub const fn new_raw(numer: T, denom: T) -> Ratio<T>`[src]

Creates a `Ratio` without checking for `denom == 0` or reducing.

There are several methods that will panic if used on a `Ratio` with `denom == 0`.

#### `pub const fn numer(&self) -> &T`[src]

Gets an immutable reference to the numerator.

#### `pub const fn denom(&self) -> &T`[src]

Gets an immutable reference to the denominator.

### `impl<T: Clone + Integer> Ratio<T>`[src]

#### `pub fn new(numer: T, denom: T) -> Ratio<T>`[src]

Creates a new `Ratio`.

Panics if `denom` is zero.

#### `pub fn from_integer(t: T) -> Ratio<T>`[src]

Creates a `Ratio` representing the integer `t`.

#### `pub fn to_integer(&self) -> T`[src]

Converts to an integer, rounding towards zero.

#### `pub fn is_integer(&self) -> bool`[src]

Returns true if the rational number is an integer (denominator is 1).

#### `pub fn reduced(&self) -> Ratio<T>`[src]

Returns a reduced copy of self.

In general, it is not necessary to use this method, as the only method of procuring a non-reduced fraction is through `new_raw`.

Panics if `denom` is zero.

#### `pub fn recip(&self) -> Ratio<T>`[src]

Returns the reciprocal.

Panics if the `Ratio` is zero.

#### `pub fn floor(&self) -> Ratio<T>`[src]

Rounds towards minus infinity.

#### `pub fn ceil(&self) -> Ratio<T>`[src]

Rounds towards plus infinity.

#### `pub fn round(&self) -> Ratio<T>`[src]

Rounds to the nearest integer. Rounds half-way cases away from zero.

#### `pub fn trunc(&self) -> Ratio<T>`[src]

Rounds towards zero.

#### `pub fn fract(&self) -> Ratio<T>`[src]

Returns the fractional part of a number, with division rounded towards zero.

Satisfies `self == self.trunc() + self.fract()`.

#### `pub fn pow(&self, expon: i32) -> Ratio<T> where    &'a T: Pow<u32, Output = T>, `[src]

Raises the `Ratio` to the power of an exponent.

### `impl Ratio<BigInt>`[src]

#### `pub fn from_float<T: FloatCore>(f: T) -> Option<BigRational>`[src]

Converts a float into a rational number.

## Trait Implementations

### `impl<'a, T> Add<&'a Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<'a, T> Add<&'a T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<'a, 'b, T: Clone + Integer> Add<&'b Ratio<T>> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<'a, 'b, T: Clone + Integer> Add<&'b T> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<'a, T> Add<Ratio<T>> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<T: Clone + Integer> Add<Ratio<T>> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<'a, T> Add<T> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<T: Clone + Integer> Add<T> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `+` operator.

### `impl<'a, T> Div<&'a Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<'a, T> Div<&'a T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<'a, 'b, T: Clone + Integer> Div<&'b Ratio<T>> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<'a, 'b, T: Clone + Integer> Div<&'b T> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<'a, T> Div<Ratio<T>> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<T> Div<Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<'a, T> Div<T> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<T> Div<T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `/` operator.

### `impl<T: FromStr + Clone + Integer> FromStr for Ratio<T>`[src]

#### `type Err = ParseRatioError`

The associated error which can be returned from parsing.

#### `fn from_str(s: &str) -> Result<Ratio<T>, ParseRatioError>`[src]

Parses `numer/denom` or just `numer`.

### `impl<T> Inv for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T> Inv for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T> Mul<&'a Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<'a, T> Mul<&'a T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<'a, 'b, T: Clone + Integer> Mul<&'b Ratio<T>> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<'a, 'b, T: Clone + Integer> Mul<&'b T> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<'a, T> Mul<Ratio<T>> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<T> Mul<Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<'a, T> Mul<T> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<T> Mul<T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `*` operator.

### `impl<T> Neg for Ratio<T> where    T: Clone + Integer + Neg<Output = T>, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<'a, T> Neg for &'a Ratio<T> where    T: Clone + Integer + Neg<Output = T>, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<T: Clone + Integer> Num for Ratio<T>`[src]

#### `fn from_str_radix(s: &str, radix: u32) -> Result<Ratio<T>, ParseRatioError>`[src]

Parses `numer/denom` where the numbers are in base `radix`.

### `impl<'b, T: Clone + Integer + Pow<&'b BigUint, Output = T>> Pow<&'b BigInt> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b BigInt> for &'a Ratio<T> where    &'a T: Pow<&'b BigUint, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<&'b BigUint, Output = T>> Pow<&'b BigUint> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b BigUint> for &'a Ratio<T> where    &'a T: Pow<&'b BigUint, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u128, Output = T>> Pow<&'b i128> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b i128> for &'a Ratio<T> where    &'a T: Pow<u128, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u16, Output = T>> Pow<&'b i16> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b i16> for &'a Ratio<T> where    &'a T: Pow<u16, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u32, Output = T>> Pow<&'b i32> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b i32> for &'a Ratio<T> where    &'a T: Pow<u32, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u64, Output = T>> Pow<&'b i64> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b i64> for &'a Ratio<T> where    &'a T: Pow<u64, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u8, Output = T>> Pow<&'b i8> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b i8> for &'a Ratio<T> where    &'a T: Pow<u8, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<usize, Output = T>> Pow<&'b isize> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b isize> for &'a Ratio<T> where    &'a T: Pow<usize, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u128, Output = T>> Pow<&'b u128> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b u128> for &'a Ratio<T> where    &'a T: Pow<u128, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u16, Output = T>> Pow<&'b u16> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b u16> for &'a Ratio<T> where    &'a T: Pow<u16, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u32, Output = T>> Pow<&'b u32> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b u32> for &'a Ratio<T> where    &'a T: Pow<u32, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u64, Output = T>> Pow<&'b u64> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b u64> for &'a Ratio<T> where    &'a T: Pow<u64, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<u8, Output = T>> Pow<&'b u8> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b u8> for &'a Ratio<T> where    &'a T: Pow<u8, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'b, T: Clone + Integer + Pow<usize, Output = T>> Pow<&'b usize> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, 'b, T: Clone + Integer> Pow<&'b usize> for &'a Ratio<T> where    &'a T: Pow<usize, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + for<'b> Pow<&'b BigUint, Output = T>> Pow<BigInt> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<BigInt> for &'a Ratio<T> where    &'a T: for<'b> Pow<&'b BigUint, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + for<'b> Pow<&'b BigUint, Output = T>> Pow<BigUint> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<BigUint> for &'a Ratio<T> where    &'a T: for<'b> Pow<&'b BigUint, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u128, Output = T>> Pow<i128> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<i128> for &'a Ratio<T> where    &'a T: Pow<u128, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u16, Output = T>> Pow<i16> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<i16> for &'a Ratio<T> where    &'a T: Pow<u16, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u32, Output = T>> Pow<i32> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<i32> for &'a Ratio<T> where    &'a T: Pow<u32, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u64, Output = T>> Pow<i64> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<i64> for &'a Ratio<T> where    &'a T: Pow<u64, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u8, Output = T>> Pow<i8> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<i8> for &'a Ratio<T> where    &'a T: Pow<u8, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<usize, Output = T>> Pow<isize> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<isize> for &'a Ratio<T> where    &'a T: Pow<usize, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u128, Output = T>> Pow<u128> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<u128> for &'a Ratio<T> where    &'a T: Pow<u128, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u16, Output = T>> Pow<u16> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<u16> for &'a Ratio<T> where    &'a T: Pow<u16, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u32, Output = T>> Pow<u32> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<u32> for &'a Ratio<T> where    &'a T: Pow<u32, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u64, Output = T>> Pow<u64> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<u64> for &'a Ratio<T> where    &'a T: Pow<u64, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<u8, Output = T>> Pow<u8> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<u8> for &'a Ratio<T> where    &'a T: Pow<u8, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<T: Clone + Integer + Pow<usize, Output = T>> Pow<usize> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T: Clone + Integer> Pow<usize> for &'a Ratio<T> where    &'a T: Pow<usize, Output = T>, `[src]

#### `type Output = Ratio<T>`

The result after applying the operator.

### `impl<'a, T> Rem<&'a Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<'a, T> Rem<&'a T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<'a, 'b, T: Clone + Integer> Rem<&'b Ratio<T>> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<'a, 'b, T: Clone + Integer> Rem<&'b T> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<'a, T> Rem<Ratio<T>> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<T: Clone + Integer> Rem<Ratio<T>> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<'a, T> Rem<T> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<T: Clone + Integer> Rem<T> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `%` operator.

### `impl<'a, T> Sub<&'a Ratio<T>> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<'a, T> Sub<&'a T> for Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<'a, 'b, T: Clone + Integer> Sub<&'b Ratio<T>> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<'a, 'b, T: Clone + Integer> Sub<&'b T> for &'a Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<'a, T> Sub<Ratio<T>> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<T: Clone + Integer> Sub<Ratio<T>> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<'a, T> Sub<T> for &'a Ratio<T> where    T: Clone + Integer, `[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

### `impl<T: Clone + Integer> Sub<T> for Ratio<T>`[src]

#### `type Output = Ratio<T>`

The resulting type after applying the `-` operator.

## Blanket Implementations

### `impl<T> ToOwned for T where    T: Clone, `[src]

#### `type Owned = T`

The resulting type after obtaining ownership.

### `impl<T, U> TryFrom<U> for T where    U: Into<T>, `[src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

### `impl<T, U> TryInto<U> for T where    U: TryFrom<T>, `[src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.