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

    #[lang = "index_mut"]pub trait IndexMut<Idx>: Index<Idx> where
        Idx: ?Sized, {
        pub fn index_mut(&mut self, index: Idx) -> &mut Self::Output;
    }

Used for indexing operations (`container[index]`) in mutable contexts.

`container[index]` is actually syntactic sugar for `*container.index_mut(index)`, but only when used as a mutable value. If an immutable value is requested, the `Index` trait is used instead. This allows nice things such as `v[index] = value`.

# Examples

A very simple implementation of a `Balance` struct that has two sides, where each can be indexed mutably and immutably.

    use std::ops::{Index, IndexMut};

    #[derive(Debug)]
    enum Side {
        Left,
        Right,
    }

    #[derive(Debug, PartialEq)]
    enum Weight {
        Kilogram(f32),
        Pound(f32),
    }

    struct Balance {
        pub left: Weight,
        pub right: Weight,
    }

    impl Index<Side> for Balance {
        type Output = Weight;

        fn index(&self, index: Side) -> &Self::Output {
            println!("Accessing {:?}-side of balance immutably", index);
            match index {
                Side::Left => &self.left,
                Side::Right => &self.right,
            }
        }
    }

    impl IndexMut<Side> for Balance {
        fn index_mut(&mut self, index: Side) -> &mut Self::Output {
            println!("Accessing {:?}-side of balance mutably", index);
            match index {
                Side::Left => &mut self.left,
                Side::Right => &mut self.right,
            }
        }
    }

    let mut balance = Balance {
        right: Weight::Kilogram(2.5),
        left: Weight::Pound(1.5),
    };

    // In this case, `balance[Side::Right]` is sugar for
    // `*balance.index(Side::Right)`, since we are only *reading*
    // `balance[Side::Right]`, not writing it.
    assert_eq!(balance[Side::Right], Weight::Kilogram(2.5));

    // However, in this case `balance[Side::Left]` is sugar for
    // `*balance.index_mut(Side::Left)`, since we are writing
    // `balance[Side::Left]`.
    balance[Side::Left] = Weight::Kilogram(3.0);

Run

## Required methods

### `pub fn index_mut(&mut self, index: Idx) -> &mut Self::Output`[src]

Performs the mutable indexing (`container[index]`) operation.

Loading content...

## Implementors

### `impl IndexMut<Range<usize>> for String` 1.3.0[src]

#### `pub fn index_mut(&mut self, index: Range<usize>) -> &mut str`[src]

### `impl IndexMut<RangeFrom<usize>> for String` 1.3.0[src]

#### `pub fn index_mut(&mut self, index: RangeFrom<usize>) -> &mut str`[src]

### `impl IndexMut<RangeFull> for OsString` 1.44.0[src]

#### `fn index_mut(&mut self, _index: RangeFull) -> &mut OsStr`[src]

### `impl IndexMut<RangeFull> for String` 1.3.0[src]

#### `pub fn index_mut(&mut self, _index: RangeFull) -> &mut str`[src]

### `impl IndexMut<RangeInclusive<usize>> for String` 1.26.0[src]

#### `pub fn index_mut(&mut self, index: RangeInclusive<usize>) -> &mut str`[src]

### `impl IndexMut<RangeTo<usize>> for String` 1.3.0[src]

#### `pub fn index_mut(&mut self, index: RangeTo<usize>) -> &mut str`[src]

### `impl IndexMut<RangeToInclusive<usize>> for String` 1.26.0[src]

#### `pub fn index_mut(&mut self, index: RangeToInclusive<usize>) -> &mut str`[src]

### `impl<A> IndexMut<usize> for VecDeque<A>`[src]

#### `pub fn index_mut(&mut self, index: usize) -> &mut Aⓘ

### Notable traits for &'_ mut F

`impl<'_, F> Future for &'_ mut F where
F: Unpin + Future + ?Sized, type Output = <F as Future>::Output;impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<R: Read + ?Sized> Read for &mut Rimpl<W: Write + ?Sized> Write for &mut W`
`[src]

### `impl<I> IndexMut<I> for str where
I: SliceIndex<str>,` [src]

#### `pub fn index_mut(&mut self, index: I) -> &mut <I as SliceIndex<str>>::Output`[src]

### `impl<T, I> IndexMut<I> for [T] where
I: SliceIndex<[T]>,` [src]

#### `pub fn index_mut(&mut self, index: I) -> &mut <I as SliceIndex<[T]>>::Output`[src]

### `impl<T, I, A> IndexMut<I> for Vec<T, A> where
I: SliceIndex<[T]>,
A: Allocator,` [src]

#### `pub fn index_mut(&mut self, index: I) -> &mut <Vec<T, A> as Index<I>>::Outputⓘ

### Notable traits for Vec<u8>

`impl Write for Vec<u8>`
`[src]

### `impl<T, I, const N: usize> IndexMut<I> for [T; N] where
[T]: IndexMut<I>,` 1.50.0[src]

#### `pub fn index_mut(&mut self, index: I) -> &mut <[T; N] as Index<I>>::Output`[src]

Loading content...