# Trait std::ops::Neg 1.0.0[−][src]

    #[lang = "neg"]
    pub trait Neg {
        type Output;
        #[must_use]
    fn neg(self) -> Self::Output;
    }

The unary negation operator `-`.

# Examples

An implementation of `Neg` for `Sign`, which allows the use of `-` to negate its value.

    use std::ops::Neg;

    #[derive(Debug, PartialEq)]
    enum Sign {
        Negative,
        Zero,
        Positive,
    }

    impl Neg for Sign {
        type Output = Sign;

        fn neg(self) -> Sign {
            match self {
                Sign::Negative => Sign::Positive,
                Sign::Zero => Sign::Zero,
                Sign::Positive => Sign::Negative,
            }
        }
    }

    // A negative positive is a negative.
    assert_eq!(-Sign::Positive, Sign::Negative);
    // A double negative is a positive.
    assert_eq!(-Sign::Negative, Sign::Positive);
    // Zero is its own negation.
    assert_eq!(-Sign::Zero, Sign::Zero);Run

## Associated Types

### `type Output`

The resulting type after applying the `-` operator.

## Required Methods

### `
#[must_use]
fn neg(self) -> Self::Output`

Performs the unary `-` operation.

## Implementors

- `impl Neg for Wrapping<u128> type Output = Wrapping<u128>;` | [src]

- `impl<'a> Neg for &'a f64 type Output = <f64 as Neg>::Output;` | [src]

- `impl Neg for f64 type Output = f64;` | [src]

- `impl Neg for i32 type Output = i32;` | [src]

- `impl Neg for i8 type Output = i8;` | [src]

- `impl Neg for i64 type Output = i64;` | [src]

- `impl Neg for Wrapping<u16> type Output = Wrapping<u16>;` | [src]

- `impl Neg for Wrapping<i16> type Output = Wrapping<i16>;` | [src]

- `impl Neg for Wrapping<u32> type Output = Wrapping<u32>;` | [src]

- `impl<'a> Neg for &'a Wrapping<u16> type Output = <Wrapping<u16> as Neg>::Output;` | [src]

- `impl Neg for Wrapping<i32> type Output = Wrapping<i32>;` | [src]

- `impl Neg for isize type Output = isize;` | [src]

- `impl Neg for Wrapping<u8> type Output = Wrapping<u8>;` | [src]

- `impl<'a> Neg for &'a Wrapping<i128> type Output = <Wrapping<i128> as Neg>::Output;` | [src]

- `impl Neg for Wrapping<i8> type Output = Wrapping<i8>;` | [src]

- `impl<'a> Neg for &'a i32 type Output = <i32 as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<isize> type Output = <Wrapping<isize> as Neg>::Output;` | [src]

- `impl Neg for Wrapping<i128> type Output = Wrapping<i128>;` | [src]

- `impl<'a> Neg for &'a i64 type Output = <i64 as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<usize> type Output = <Wrapping<usize> as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a f32 type Output = <f32 as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a isize type Output = <isize as Neg>::Output;` | [src]

- `impl Neg for Wrapping<isize> type Output = Wrapping<isize>;` | [src]

- `impl<'a> Neg for &'a Wrapping<u8> type Output = <Wrapping<u8> as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<i8> type Output = <Wrapping<i8> as Neg>::Output;` | [src]

- `impl Neg for i128 type Output = i128;` | [src]

- `impl<'a> Neg for &'a Wrapping<i16> type Output = <Wrapping<i16> as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<u64> type Output = <Wrapping<u64> as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a i8 type Output = <i8 as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<u128> type Output = <Wrapping<u128> as Neg>::Output;` | [src]

- `impl Neg for Wrapping<u64> type Output = Wrapping<u64>;` | [src]

- `impl Neg for Wrapping<usize> type Output = Wrapping<usize>;` | [src]

- `impl<'a> Neg for &'a i16 type Output = <i16 as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<u32> type Output = <Wrapping<u32> as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a i128 type Output = <i128 as Neg>::Output;` | [src]

- `impl Neg for f32 type Output = f32;` | [src]

- `impl Neg for Wrapping<i64> type Output = Wrapping<i64>;` | [src]

- `impl Neg for i16 type Output = i16;` | [src]

- `impl<'a> Neg for &'a Wrapping<i32> type Output = <Wrapping<i32> as Neg>::Output;` | [src]

- `impl<'a> Neg for &'a Wrapping<i64> type Output = <Wrapping<i64> as Neg>::Output;` | [src]

# 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`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)