#[lang = "index_mut"]pub trait IndexMut<Idx>: Index<Idx> where Idx: ?Sized, {
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.
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);fn index_mut(&mut self, index: Idx) -> &mut Self::OutputPerforms the mutable indexing (container[index]) operation.
impl IndexMut<Range<usize>> for String[src]
impl IndexMut<RangeFrom<usize>> for String[src]
impl IndexMut<RangeFull> for OsString[src]
impl IndexMut<RangeFull> for String[src]
impl IndexMut<RangeInclusive<usize>> for String[src]
fn index_mut(&mut self, index: RangeInclusive<usize>) -> &mut str[src]
impl IndexMut<RangeTo<usize>> for String[src]
impl IndexMut<RangeToInclusive<usize>> for String[src]
fn index_mut(&mut self, index: RangeToInclusive<usize>) -> &mut str[src]
impl<A> IndexMut<usize> for VecDeque<A>[src]
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 R
impl<W: Write + ?Sized, '_> Write for &'_ mut W
[src]
impl<I> IndexMut<I> for str where
I: SliceIndex<str>, [src]
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]
impl<T, I> IndexMut<I> for Vec<T> where
I: SliceIndex<[T]>, [src]
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/ops/trait.IndexMut.html