Trait nom::lib::std::ops::Rem

#[lang = "rem"]
pub trait Rem<RHS = Self> {
    type Output = Self;
    
#[must_use]
fn rem(self, rhs: RHS) -> Self::Output;
}

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 = SplitSlice<'a, T>;

    fn rem(self, modulus: usize) -> Self {
        let len = self.slice.len();
        let rem = len % modulus;
        let start = len - rem;
        SplitSlice {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] });

Associated Types

type Output = Self

The resulting type after applying the % operator.

Required Methods

#[must_use]

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

Performs the % operation.

Implementations on Foreign Types

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

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

fn rem(self, other: u128) -> <u128 as Rem<u128>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<i8> ) -> <Wrapping<i8> as Rem<Wrapping<i8>>>::Output

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

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

fn rem(self, other: u32) -> <u32 as Rem<u32>>::Output

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

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

fn rem(self, other: &'a f64) -> <f64 as Rem<f64>>::Output

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

type Output = Wrapping<u8>

fn rem(self, other: Wrapping<u8>) -> Wrapping<u8>

impl Rem<isize> for isize

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

type Output = isize

fn rem(self, other: isize) -> isize

impl<'a, 'b> Rem<&'a Wrapping<i8>> for &'b Wrapping<i8>

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

fn rem(     self,     other: &'a Wrapping<i8> ) -> <Wrapping<i8> as Rem<Wrapping<i8>>>::Output

impl<'a, 'b> Rem<&'a f64> for &'b f64

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

fn rem(self, other: &'a f64) -> <f64 as Rem<f64>>::Output

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

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

fn rem(self, other: &'a u8) -> <u8 as Rem<u8>>::Output

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

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

fn rem(self, other: &'a u16) -> <u16 as Rem<u16>>::Output

impl Rem<u64> for u64

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

type Output = u64

fn rem(self, other: u64) -> u64

impl<'a, 'b> Rem<&'a f32> for &'b f32

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

fn rem(self, other: &'a f32) -> <f32 as Rem<f32>>::Output

impl<'a, 'b> Rem<&'a Wrapping<u64>> for &'b Wrapping<u64>

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

fn rem(     self,     other: &'a Wrapping<u64> ) -> <Wrapping<u64> as Rem<Wrapping<u64>>>::Output

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

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

fn rem(self, other: &'a u128) -> <u128 as Rem<u128>>::Output

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

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

fn rem(self, other: i64) -> <i64 as Rem<i64>>::Output

impl<'a, 'b> Rem<&'a u128> for &'b u128

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

fn rem(self, other: &'a u128) -> <u128 as Rem<u128>>::Output

impl<'a, 'b> Rem<&'a Wrapping<i32>> for &'b Wrapping<i32>

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

fn rem(     self,     other: &'a Wrapping<i32> ) -> <Wrapping<i32> as Rem<Wrapping<i32>>>::Output

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

type Output = Wrapping<i64>

fn rem(self, other: Wrapping<i64>) -> Wrapping<i64>

impl Rem<f64> for f64

type Output = f64

fn rem(self, other: f64) -> f64

impl Rem<u32> for u32

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

type Output = u32

fn rem(self, other: u32) -> u32

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

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

fn rem(     self,     other: &'a Wrapping<i128> ) -> <Wrapping<i128> as Rem<Wrapping<i128>>>::Output

impl<'a, 'b> Rem<&'a u32> for &'b u32

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

fn rem(self, other: &'a u32) -> <u32 as Rem<u32>>::Output

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

type Output = Wrapping<u128>

fn rem(self, other: Wrapping<u128>) -> Wrapping<u128>

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

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

fn rem(self, other: i16) -> <i16 as Rem<i16>>::Output

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

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

fn rem(     self,     other: Wrapping<i64> ) -> <Wrapping<i64> as Rem<Wrapping<i64>>>::Output

impl<'a, 'b> Rem<&'a Wrapping<isize>> for &'b Wrapping<isize>

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

fn rem(     self,     other: &'a Wrapping<isize> ) -> <Wrapping<isize> as Rem<Wrapping<isize>>>::Output

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

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

fn rem(     self,     other: Wrapping<u128> ) -> <Wrapping<u128> as Rem<Wrapping<u128>>>::Output

impl<'a, 'b> Rem<&'a isize> for &'b isize

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

fn rem(self, other: &'a isize) -> <isize as Rem<isize>>::Output

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

type Output = Wrapping<i8>

fn rem(self, other: Wrapping<i8>) -> Wrapping<i8>

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

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

fn rem(self, other: &'a i16) -> <i16 as Rem<i16>>::Output

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

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

fn rem(     self,     other: Wrapping<i128> ) -> <Wrapping<i128> as Rem<Wrapping<i128>>>::Output

impl Rem<u8> for u8

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

type Output = u8

fn rem(self, other: u8) -> u8

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

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

fn rem(self, other: i32) -> <i32 as Rem<i32>>::Output

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

type Output = Wrapping<isize>

fn rem(self, other: Wrapping<isize>) -> Wrapping<isize>

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

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

fn rem(     self,     other: &'a Wrapping<u128> ) -> <Wrapping<u128> as Rem<Wrapping<u128>>>::Output

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

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

fn rem(self, other: &'a i128) -> <i128 as Rem<i128>>::Output

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

type Output = Wrapping<u64>

fn rem(self, other: Wrapping<u64>) -> Wrapping<u64>

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

type Output = Wrapping<i128>

fn rem(self, other: Wrapping<i128>) -> Wrapping<i128>

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

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

fn rem(self, other: &'a u64) -> <u64 as Rem<u64>>::Output

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

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

fn rem(     self,     other: Wrapping<i32> ) -> <Wrapping<i32> as Rem<Wrapping<i32>>>::Output

impl<'a, 'b> Rem<&'a i8> for &'b i8

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

fn rem(self, other: &'a i8) -> <i8 as Rem<i8>>::Output

impl Rem<i64> for i64

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

type Output = i64

fn rem(self, other: i64) -> i64

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

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

fn rem(self, other: &'a i64) -> <i64 as Rem<i64>>::Output

impl Rem<usize> for usize

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

type Output = usize

fn rem(self, other: usize) -> usize

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

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

fn rem(     self,     other: &'a Wrapping<i64> ) -> <Wrapping<i64> as Rem<Wrapping<i64>>>::Output

impl<'a> Rem<Wrapping<usize>> for &'a Wrapping<usize>

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

fn rem(     self,     other: Wrapping<usize> ) -> <Wrapping<usize> as Rem<Wrapping<usize>>>::Output

impl<'a, 'b> Rem<&'a i128> for &'b i128

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

fn rem(self, other: &'a i128) -> <i128 as Rem<i128>>::Output

impl<'a, 'b> Rem<&'a Wrapping<u128>> for &'b Wrapping<u128>

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

fn rem(     self,     other: &'a Wrapping<u128> ) -> <Wrapping<u128> as Rem<Wrapping<u128>>>::Output

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

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

fn rem(self, other: u16) -> <u16 as Rem<u16>>::Output

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

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

fn rem(     self,     other: Wrapping<i16> ) -> <Wrapping<i16> as Rem<Wrapping<i16>>>::Output

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

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

fn rem(self, other: &'a u32) -> <u32 as Rem<u32>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<i32> ) -> <Wrapping<i32> as Rem<Wrapping<i32>>>::Output

impl Rem<i16> for i16

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

type Output = i16

fn rem(self, other: i16) -> i16

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

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

fn rem(     self,     other: Wrapping<isize> ) -> <Wrapping<isize> as Rem<Wrapping<isize>>>::Output

impl<'a, 'b> Rem<&'a Wrapping<i128>> for &'b Wrapping<i128>

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

fn rem(     self,     other: &'a Wrapping<i128> ) -> <Wrapping<i128> as Rem<Wrapping<i128>>>::Output

impl<'a, 'b> Rem<&'a Wrapping<i16>> for &'b Wrapping<i16>

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

fn rem(     self,     other: &'a Wrapping<i16> ) -> <Wrapping<i16> as Rem<Wrapping<i16>>>::Output

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

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

fn rem(     self,     other: Wrapping<u32> ) -> <Wrapping<u32> as Rem<Wrapping<u32>>>::Output

impl<'a> Rem<&'a Wrapping<usize>> for Wrapping<usize>

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

fn rem(     self,     other: &'a Wrapping<usize> ) -> <Wrapping<usize> as Rem<Wrapping<usize>>>::Output

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

type Output = Wrapping<usize>

fn rem(self, other: Wrapping<usize>) -> Wrapping<usize>

impl<'a, 'b> Rem<&'a Wrapping<usize>> for &'b Wrapping<usize>

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

fn rem(     self,     other: &'a Wrapping<usize> ) -> <Wrapping<usize> as Rem<Wrapping<usize>>>::Output

impl Rem<i8> for i8

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

type Output = i8

fn rem(self, other: i8) -> i8

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

type Output = Wrapping<u16>

fn rem(self, other: Wrapping<u16>) -> Wrapping<u16>

impl Rem<i32> for i32

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

type Output = i32

fn rem(self, other: i32) -> i32

impl<'a, 'b> Rem<&'a i64> for &'b i64

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

fn rem(self, other: &'a i64) -> <i64 as Rem<i64>>::Output

impl<'a, 'b> Rem<&'a usize> for &'b usize

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

fn rem(self, other: &'a usize) -> <usize as Rem<usize>>::Output

impl<'a, 'b> Rem<&'a i16> for &'b i16

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

fn rem(self, other: &'a i16) -> <i16 as Rem<i16>>::Output

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

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

fn rem(self, other: &'a isize) -> <isize as Rem<isize>>::Output

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

type Output = Wrapping<u32>

fn rem(self, other: Wrapping<u32>) -> Wrapping<u32>

impl<'a, 'b> Rem<&'a Wrapping<u8>> for &'b Wrapping<u8>

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

fn rem(     self,     other: &'a Wrapping<u8> ) -> <Wrapping<u8> as Rem<Wrapping<u8>>>::Output

impl<'a, 'b> Rem<&'a u64> for &'b u64

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

fn rem(self, other: &'a u64) -> <u64 as Rem<u64>>::Output

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

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

fn rem(self, other: &'a usize) -> <usize as Rem<usize>>::Output

impl Rem<i128> for i128

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

type Output = i128

fn rem(self, other: i128) -> i128

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

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

fn rem(self, other: f64) -> <f64 as Rem<f64>>::Output

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

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

fn rem(self, other: Wrapping<i8>) -> <Wrapping<i8> as Rem<Wrapping<i8>>>::Output

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

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

fn rem(self, other: usize) -> <usize as Rem<usize>>::Output

impl Rem<f32> for f32

type Output = f32

fn rem(self, other: f32) -> f32

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

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

fn rem(     self,     other: &'a Wrapping<u32> ) -> <Wrapping<u32> as Rem<Wrapping<u32>>>::Output

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

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

fn rem(self, other: u8) -> <u8 as Rem<u8>>::Output

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

type Output = Wrapping<i16>

fn rem(self, other: Wrapping<i16>) -> Wrapping<i16>

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

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

fn rem(self, other: i8) -> <i8 as Rem<i8>>::Output

impl Rem<u128> for u128

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

type Output = u128

fn rem(self, other: u128) -> u128

impl<'a, 'b> Rem<&'a u8> for &'b u8

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

fn rem(self, other: &'a u8) -> <u8 as Rem<u8>>::Output

impl<'a, 'b> Rem<&'a Wrapping<u32>> for &'b Wrapping<u32>

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

fn rem(     self,     other: &'a Wrapping<u32> ) -> <Wrapping<u32> as Rem<Wrapping<u32>>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<u64> ) -> <Wrapping<u64> as Rem<Wrapping<u64>>>::Output

impl<'a, 'b> Rem<&'a u16> for &'b u16

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

fn rem(self, other: &'a u16) -> <u16 as Rem<u16>>::Output

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

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

fn rem(self, other: i128) -> <i128 as Rem<i128>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<i16> ) -> <Wrapping<i16> as Rem<Wrapping<i16>>>::Output

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

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

fn rem(self, other: isize) -> <isize as Rem<isize>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<isize> ) -> <Wrapping<isize> as Rem<Wrapping<isize>>>::Output

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

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

fn rem(self, other: &'a i8) -> <i8 as Rem<i8>>::Output

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

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

fn rem(self, other: u64) -> <u64 as Rem<u64>>::Output

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

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

fn rem(self, other: &'a f32) -> <f32 as Rem<f32>>::Output

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

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

fn rem(self, other: &'a i32) -> <i32 as Rem<i32>>::Output

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

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

fn rem(self, other: f32) -> <f32 as Rem<f32>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<u8> ) -> <Wrapping<u8> as Rem<Wrapping<u8>>>::Output

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

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

fn rem(self, other: Wrapping<u8>) -> <Wrapping<u8> as Rem<Wrapping<u8>>>::Output

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

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

fn rem(     self,     other: Wrapping<u64> ) -> <Wrapping<u64> as Rem<Wrapping<u64>>>::Output

impl<'a, 'b> Rem<&'a Wrapping<u16>> for &'b Wrapping<u16>

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

fn rem(     self,     other: &'a Wrapping<u16> ) -> <Wrapping<u16> as Rem<Wrapping<u16>>>::Output

impl<'a, 'b> Rem<&'a Wrapping<i64>> for &'b Wrapping<i64>

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

fn rem(     self,     other: &'a Wrapping<i64> ) -> <Wrapping<i64> as Rem<Wrapping<i64>>>::Output

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

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

fn rem(     self,     other: Wrapping<u16> ) -> <Wrapping<u16> as Rem<Wrapping<u16>>>::Output

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

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

fn rem(     self,     other: &'a Wrapping<u16> ) -> <Wrapping<u16> as Rem<Wrapping<u16>>>::Output

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

type Output = Wrapping<i32>

fn rem(self, other: Wrapping<i32>) -> Wrapping<i32>

impl Rem<u16> for u16

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

type Output = u16

fn rem(self, other: u16) -> u16

impl<'a, 'b> Rem<&'a i32> for &'b i32

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

fn rem(self, other: &'a i32) -> <i32 as Rem<i32>>::Output

Implementors