std::ops::SubAssign - Rust
Description: API documentation for the Rust `SubAssign` trait in crate `std`.
Keywords: rust, rustlang, rust-lang, SubAssign

# Trait std::ops::SubAssign 1.8.0 [−] [src]

    #[lang = "sub_assign"]
    pub trait SubAssign<Rhs = Self> {
        fn sub_assign(&mut self, rhs: Rhs);
    }

The subtraction assignment operator `-=`.

# Examples

This example creates a `Point` struct that implements the `SubAssign` trait, and then demonstrates sub-assigning to a mutable `Point`.

    use std::ops::SubAssign;

    #[derive(Debug)]
    struct Point {
        x: i32,
        y: i32,
    }

    impl SubAssign for Point {
        fn sub_assign(&mut self, other: Point) {
            *self = Point {
                x: self.x - other.x,
                y: self.y - other.y,
            };
        }
    }

    impl PartialEq for Point {
        fn eq(&self, other: &Self) -> bool {
            self.x == other.x && self.y == other.y
        }
    }

    let mut point = Point { x: 3, y: 3 };
    point -= Point { x: 2, y: 3 };
    assert_eq!(point, Point {x: 1, y: 0});Run

## Required Methods

### `fn sub_assign(&mut self, rhs: Rhs)`

The method for the `-=` operator

## Implementors

- `impl SubAssign<Wrapping<u8>> for Wrapping<u8>`
- `impl SubAssign<Wrapping<u128>> for Wrapping<u128>`
- `impl SubAssign<Wrapping<u16>> for Wrapping<u16>`
- `impl SubAssign<i8> for i8`
- `impl SubAssign<Wrapping<usize>> for Wrapping<usize>`
- `impl SubAssign<Wrapping<i64>> for Wrapping<i64>`
- `impl SubAssign<Wrapping<i8>> for Wrapping<i8>`
- `impl SubAssign<u32> for u32`
- `impl SubAssign<usize> for usize`
- `impl SubAssign<i32> for i32`
- `impl SubAssign<f32> for f32`
- `impl SubAssign<Wrapping<u32>> for Wrapping<u32>`
- `impl SubAssign<isize> for isize`
- `impl SubAssign<Wrapping<u64>> for Wrapping<u64>`
- `impl SubAssign<u8> for u8`
- `impl SubAssign<u128> for u128`
- `impl SubAssign<Wrapping<i32>> for Wrapping<i32>`
- `impl SubAssign<u16> for u16`
- `impl SubAssign<u64> for u64`
- `impl SubAssign<Wrapping<i16>> for Wrapping<i16>`
- `impl SubAssign<Wrapping<i128>> for Wrapping<i128>`
- `impl SubAssign<i128> for i128`
- `impl SubAssign<f64> for f64`
- `impl SubAssign<i64> for i64`
- `impl SubAssign<i16> for i16`
- `impl SubAssign<Wrapping<isize>> for Wrapping<isize>`
- `impl SubAssign for Duration`
- `impl SubAssign<Duration> for Instant`
- `impl SubAssign<Duration> for SystemTime`

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)