# Trait core::ops::Rem

1.0.0 · source ·
``````pub trait Rem<Rhs = Self> {
type Output;

fn rem(self, rhs: Rhs) -> Self::Output;
}``````
Expand description

The remainder operator `%`.

Note that `Rhs` is `Self` by default, but this is not mandatory.

## Examples

This example implements `Rem` on a `SplitSlice` object. After `Rem` is implemented, one can use the `%` operator to find out what the remaining elements of the slice would be after splitting it into equal slices of a given length.

``````use std::ops::Rem;

#[derive(PartialEq, Debug)]
struct SplitSlice<'a, T: 'a> {
slice: &'a [T],
}

impl<'a, T> Rem<usize> for SplitSlice<'a, T> {
type Output = Self;

fn rem(self, modulus: usize) -> Self::Output {
let len = self.slice.len();
let rem = len % modulus;
let start = len - rem;
Self {slice: &self.slice[start..]}
}
}

// If we were to divide &[0, 1, 2, 3, 4, 5, 6, 7] into slices of size 3,
// the remainder would be &[6, 7].
assert_eq!(SplitSlice { slice: &[0, 1, 2, 3, 4, 5, 6, 7] } % 3,
SplitSlice { slice: &[6, 7] });``````
Run

## Required Associated Types§

source

#### type Output

The resulting type after applying the `%` operator.

## Required Methods§

source

#### fn rem(self, rhs: Rhs) -> Self::Output

Performs the `%` operation.

##### Example
``assert_eq!(12 % 10, 2);``
Run

## Implementors§

const: unstable · source§

### impl Rem<&f32> for &f32

§

#### type Output = <f32 as Rem<f32>>::Output

const: unstable · source§

### impl Rem<&f32> for f32

§

#### type Output = <f32 as Rem<f32>>::Output

const: unstable · source§

### impl Rem<&f64> for &f64

§

#### type Output = <f64 as Rem<f64>>::Output

const: unstable · source§

### impl Rem<&f64> for f64

§

#### type Output = <f64 as Rem<f64>>::Output

const: unstable · source§

### impl Rem<&i8> for &i8

§

#### type Output = <i8 as Rem<i8>>::Output

const: unstable · source§

### impl Rem<&i8> for i8

§

#### type Output = <i8 as Rem<i8>>::Output

const: unstable · source§

### impl Rem<&i16> for &i16

§

#### type Output = <i16 as Rem<i16>>::Output

const: unstable · source§

### impl Rem<&i16> for i16

§

#### type Output = <i16 as Rem<i16>>::Output

const: unstable · source§

### impl Rem<&i32> for &i32

§

#### type Output = <i32 as Rem<i32>>::Output

const: unstable · source§

### impl Rem<&i32> for i32

§

#### type Output = <i32 as Rem<i32>>::Output

const: unstable · source§

### impl Rem<&i64> for &i64

§

#### type Output = <i64 as Rem<i64>>::Output

const: unstable · source§

### impl Rem<&i64> for i64

§

#### type Output = <i64 as Rem<i64>>::Output

const: unstable · source§

### impl Rem<&i128> for &i128

§

#### type Output = <i128 as Rem<i128>>::Output

const: unstable · source§

### impl Rem<&i128> for i128

§

#### type Output = <i128 as Rem<i128>>::Output

const: unstable · source§

### impl Rem<&isize> for &isize

§

#### type Output = <isize as Rem<isize>>::Output

const: unstable · source§

### impl Rem<&isize> for isize

§

#### type Output = <isize as Rem<isize>>::Output

const: unstable · source§

### impl Rem<&u8> for &u8

§

#### type Output = <u8 as Rem<u8>>::Output

const: unstable · source§

### impl Rem<&u8> for u8

§

#### type Output = <u8 as Rem<u8>>::Output

const: unstable · source§

### impl Rem<&u16> for &u16

§

#### type Output = <u16 as Rem<u16>>::Output

const: unstable · source§

### impl Rem<&u16> for u16

§

#### type Output = <u16 as Rem<u16>>::Output

const: unstable · source§

### impl Rem<&u32> for &u32

§

#### type Output = <u32 as Rem<u32>>::Output

const: unstable · source§

### impl Rem<&u32> for u32

§

#### type Output = <u32 as Rem<u32>>::Output

const: unstable · source§

### impl Rem<&u64> for &u64

§

#### type Output = <u64 as Rem<u64>>::Output

const: unstable · source§

### impl Rem<&u64> for u64

§

#### type Output = <u64 as Rem<u64>>::Output

const: unstable · source§

### impl Rem<&u128> for &u128

§

#### type Output = <u128 as Rem<u128>>::Output

const: unstable · source§

### impl Rem<&u128> for u128

§

#### type Output = <u128 as Rem<u128>>::Output

const: unstable · source§

### impl Rem<&usize> for &usize

§

#### type Output = <usize as Rem<usize>>::Output

const: unstable · source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

### impl Rem<&Saturating<usize>> for Saturating<usize>

§

#### type Output = <Saturating<usize> as Rem<Saturating<usize>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i8>> for &Wrapping<i8>

§

#### type Output = <Wrapping<i8> as Rem<Wrapping<i8>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i8>> for Wrapping<i8>

§

#### type Output = <Wrapping<i8> as Rem<Wrapping<i8>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i16>> for &Wrapping<i16>

§

#### type Output = <Wrapping<i16> as Rem<Wrapping<i16>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i16>> for Wrapping<i16>

§

#### type Output = <Wrapping<i16> as Rem<Wrapping<i16>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i32>> for &Wrapping<i32>

§

#### type Output = <Wrapping<i32> as Rem<Wrapping<i32>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i32>> for Wrapping<i32>

§

#### type Output = <Wrapping<i32> as Rem<Wrapping<i32>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i64>> for &Wrapping<i64>

§

#### type Output = <Wrapping<i64> as Rem<Wrapping<i64>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i64>> for Wrapping<i64>

§

#### type Output = <Wrapping<i64> as Rem<Wrapping<i64>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i128>> for &Wrapping<i128>

§

#### type Output = <Wrapping<i128> as Rem<Wrapping<i128>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<i128>> for Wrapping<i128>

§

#### type Output = <Wrapping<i128> as Rem<Wrapping<i128>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<isize>> for &Wrapping<isize>

§

#### type Output = <Wrapping<isize> as Rem<Wrapping<isize>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<isize>> for Wrapping<isize>

§

#### type Output = <Wrapping<isize> as Rem<Wrapping<isize>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u8>> for &Wrapping<u8>

§

#### type Output = <Wrapping<u8> as Rem<Wrapping<u8>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u8>> for Wrapping<u8>

§

#### type Output = <Wrapping<u8> as Rem<Wrapping<u8>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u16>> for &Wrapping<u16>

§

#### type Output = <Wrapping<u16> as Rem<Wrapping<u16>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u16>> for Wrapping<u16>

§

#### type Output = <Wrapping<u16> as Rem<Wrapping<u16>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u32>> for &Wrapping<u32>

§

#### type Output = <Wrapping<u32> as Rem<Wrapping<u32>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u32>> for Wrapping<u32>

§

#### type Output = <Wrapping<u32> as Rem<Wrapping<u32>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u64>> for &Wrapping<u64>

§

#### type Output = <Wrapping<u64> as Rem<Wrapping<u64>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u64>> for Wrapping<u64>

§

#### type Output = <Wrapping<u64> as Rem<Wrapping<u64>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u128>> for &Wrapping<u128>

§

#### type Output = <Wrapping<u128> as Rem<Wrapping<u128>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<u128>> for Wrapping<u128>

§

#### type Output = <Wrapping<u128> as Rem<Wrapping<u128>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<usize>> for &Wrapping<usize>

§

#### type Output = <Wrapping<usize> as Rem<Wrapping<usize>>>::Output

1.14.0 (const: unstable) · source§

### impl Rem<&Wrapping<usize>> for Wrapping<usize>

§

#### type Output = <Wrapping<usize> as Rem<Wrapping<usize>>>::Output

const: unstable · source§

### impl Rem<f32> for f32

The remainder from the division of two floats.

The remainder has the same sign as the dividend and is computed as: `x - (x / y).trunc() * y`.

#### Examples

``````let x: f32 = 50.50;
let y: f32 = 8.125;
let remainder = x - (x / y).trunc() * y;

// The answer to both operations is 1.75
assert_eq!(x % y, remainder);``````
Run
§

#### type Output = f32

const: unstable · source§

### impl Rem<f64> for f64

The remainder from the division of two floats.

The remainder has the same sign as the dividend and is computed as: `x - (x / y).trunc() * y`.

#### Examples

``````let x: f32 = 50.50;
let y: f32 = 8.125;
let remainder = x - (x / y).trunc() * y;

// The answer to both operations is 1.75
assert_eq!(x % y, remainder);``````
Run
§

#### type Output = f64

const: unstable · source§

### impl Rem<i8> for i8

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0` or if `self / other` results in overflow.

§

#### type Output = i8

const: unstable · source§

### impl Rem<i16> for i16

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0` or if `self / other` results in overflow.

§

#### type Output = i16

const: unstable · source§

### impl Rem<i32> for i32

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0` or if `self / other` results in overflow.

§

#### type Output = i32

const: unstable · source§

### impl Rem<i64> for i64

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0` or if `self / other` results in overflow.

§

#### type Output = i64

const: unstable · source§

### impl Rem<i128> for i128

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0` or if `self / other` results in overflow.

§

#### type Output = i128

const: unstable · source§

### impl Rem<isize> for isize

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0` or if `self / other` results in overflow.

§

#### type Output = isize

const: unstable · source§

### impl Rem<u8> for u8

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0`.

§

#### type Output = u8

const: unstable · source§

### impl Rem<u16> for u16

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0`.

§

#### type Output = u16

const: unstable · source§

### impl Rem<u32> for u32

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0`.

§

#### type Output = u32

const: unstable · source§

### impl Rem<u64> for u64

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0`.

§

#### type Output = u64

const: unstable · source§

### impl Rem<u128> for u128

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0`.

§

#### type Output = u128

const: unstable · source§

### impl Rem<usize> for usize

This operation satisfies `n % d == n - (n / d) * d`. The result has the same sign as the left operand.

#### Panics

This operation will panic if `other == 0`.

§

#### type Output = usize

1.51.0 (const: unstable) · source§

### impl Rem<NonZeroU8> for u8

§

#### type Output = u8

1.51.0 (const: unstable) · source§

### impl Rem<NonZeroU16> for u16

§

#### type Output = u16

1.51.0 (const: unstable) · source§

### impl Rem<NonZeroU32> for u32

§

#### type Output = u32

1.51.0 (const: unstable) · source§

### impl Rem<NonZeroU64> for u64

§

#### type Output = u64

1.51.0 (const: unstable) · source§

### impl Rem<NonZeroU128> for u128

§

#### type Output = u128

1.51.0 (const: unstable) · source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

### impl Rem<Saturating<usize>> for Saturating<usize>

§

#### type Output = Saturating<usize>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<i8>> for Wrapping<i8>

§

#### type Output = Wrapping<i8>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<i16>> for Wrapping<i16>

§

#### type Output = Wrapping<i16>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<i32>> for Wrapping<i32>

§

#### type Output = Wrapping<i32>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<i64>> for Wrapping<i64>

§

#### type Output = Wrapping<i64>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<i128>> for Wrapping<i128>

§

#### type Output = Wrapping<i128>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<isize>> for Wrapping<isize>

§

#### type Output = Wrapping<isize>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<u8>> for Wrapping<u8>

§

#### type Output = Wrapping<u8>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<u16>> for Wrapping<u16>

§

#### type Output = Wrapping<u16>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<u32>> for Wrapping<u32>

§

#### type Output = Wrapping<u32>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<u64>> for Wrapping<u64>

§

#### type Output = Wrapping<u64>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<u128>> for Wrapping<u128>

§

#### type Output = Wrapping<u128>

1.7.0 (const: unstable) · source§

### impl Rem<Wrapping<usize>> for Wrapping<usize>

§

#### type Output = Wrapping<usize>

const: unstable · source§

### impl<'a> Rem<f32> for &'a f32

§

#### type Output = <f32 as Rem<f32>>::Output

const: unstable · source§

### impl<'a> Rem<f64> for &'a f64

§

#### type Output = <f64 as Rem<f64>>::Output

const: unstable · source§

### impl<'a> Rem<i8> for &'a i8

§

#### type Output = <i8 as Rem<i8>>::Output

const: unstable · source§

### impl<'a> Rem<i16> for &'a i16

§

#### type Output = <i16 as Rem<i16>>::Output

const: unstable · source§

### impl<'a> Rem<i32> for &'a i32

§

#### type Output = <i32 as Rem<i32>>::Output

const: unstable · source§

### impl<'a> Rem<i64> for &'a i64

§

#### type Output = <i64 as Rem<i64>>::Output

const: unstable · source§

### impl<'a> Rem<i128> for &'a i128

§

#### type Output = <i128 as Rem<i128>>::Output

const: unstable · source§

### impl<'a> Rem<isize> for &'a isize

§

#### type Output = <isize as Rem<isize>>::Output

const: unstable · source§

### impl<'a> Rem<u8> for &'a u8

§

#### type Output = <u8 as Rem<u8>>::Output

const: unstable · source§

### impl<'a> Rem<u16> for &'a u16

§

#### type Output = <u16 as Rem<u16>>::Output

const: unstable · source§

### impl<'a> Rem<u32> for &'a u32

§

#### type Output = <u32 as Rem<u32>>::Output

const: unstable · source§

### impl<'a> Rem<u64> for &'a u64

§

#### type Output = <u64 as Rem<u64>>::Output

const: unstable · source§

### impl<'a> Rem<u128> for &'a u128

§

#### type Output = <u128 as Rem<u128>>::Output

const: unstable · source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

### impl<'a> Rem<Saturating<usize>> for &'a Saturating<usize>

§

#### type Output = <Saturating<usize> as Rem<Saturating<usize>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<i8>> for &'a Wrapping<i8>

§

#### type Output = <Wrapping<i8> as Rem<Wrapping<i8>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<i16>> for &'a Wrapping<i16>

§

#### type Output = <Wrapping<i16> as Rem<Wrapping<i16>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<i32>> for &'a Wrapping<i32>

§

#### type Output = <Wrapping<i32> as Rem<Wrapping<i32>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<i64>> for &'a Wrapping<i64>

§

#### type Output = <Wrapping<i64> as Rem<Wrapping<i64>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<i128>> for &'a Wrapping<i128>

§

#### type Output = <Wrapping<i128> as Rem<Wrapping<i128>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<isize>> for &'a Wrapping<isize>

§

#### type Output = <Wrapping<isize> as Rem<Wrapping<isize>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<u8>> for &'a Wrapping<u8>

§

#### type Output = <Wrapping<u8> as Rem<Wrapping<u8>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<u16>> for &'a Wrapping<u16>

§

#### type Output = <Wrapping<u16> as Rem<Wrapping<u16>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<u32>> for &'a Wrapping<u32>

§

#### type Output = <Wrapping<u32> as Rem<Wrapping<u32>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<u64>> for &'a Wrapping<u64>

§

#### type Output = <Wrapping<u64> as Rem<Wrapping<u64>>>::Output

1.14.0 (const: unstable) · source§

### impl<'a> Rem<Wrapping<u128>> for &'a Wrapping<u128>

§

#### type Output = <Wrapping<u128> as Rem<Wrapping<u128>>>::Output

1.14.0 (const: unstable) · source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§

source§

§