     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28

    /// Saturating math operations
    pub trait Saturating {
        /// Saturating addition operator.
        /// Returns a+b, saturating at the numeric bounds instead of overflowing.
        fn saturating_add(self, v: Self) -> Self;

        /// Saturating subtraction operator.
        /// Returns a-b, saturating at the numeric bounds instead of overflowing.
        fn saturating_sub(self, v: Self) -> Self;
    }

    macro_rules! saturating_impl {
        ($trait_name:ident for $($t:ty)*) => {$(
            impl $trait_name for $t {
                #[inline]
                fn saturating_add(self, v: Self) -> Self {
                    Self::saturating_add(self, v)
                }

                #[inline]
                fn saturating_sub(self, v: Self) -> Self {
                    Self::saturating_sub(self, v)
                }
            }
        )*}
    }

    saturating_impl!(Saturating for isize usize i8 u8 i16 u16 i32 u32 i64 u64);

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse 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`)