1.0.0[−][src]Trait tract_hir::internal::tract_downcast_rs::__std::ops::IndexMut
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);
Required methods
fn index_mut(&mut self, index: Idx) -> &mut Self::Output
Performs the mutable indexing (container[index]
) operation.
Implementations on Foreign Types
impl<T, I> IndexMut<I> for [T] where
I: SliceIndex<[T]>,
[src]
I: SliceIndex<[T]>,
impl<I> IndexMut<I> for str where
I: SliceIndex<str>,
[src]
I: SliceIndex<str>,
fn index_mut(&mut self, index: I) -> &mut <I as SliceIndex<str>>::Output
[src]
impl<A, I> IndexMut<I> for SmallVec<A> where
A: Array,
I: SliceIndex<[<A as Array>::Item]>,
A: Array,
I: SliceIndex<[<A as Array>::Item]>,
fn index_mut(
&mut self,
index: I
) -> &mut <I as SliceIndex<[<A as Array>::Item]>>::Output
&mut self,
index: I
) -> &mut <I as SliceIndex<[<A as Array>::Item]>>::Output
Implementors
impl IndexMut<usize> for Dim<[usize; 0]>
[src]
impl IndexMut<usize> for Dim<[usize; 1]>
[src]
impl IndexMut<usize> for Dim<[usize; 2]>
[src]
impl IndexMut<usize> for Dim<[usize; 3]>
[src]
impl IndexMut<usize> for Dim<[usize; 4]>
[src]
impl IndexMut<usize> for Dim<[usize; 5]>
[src]
impl IndexMut<usize> for Dim<[usize; 6]>
[src]
impl IndexMut<usize> for Dim<IxDynImpl>
[src]
impl IndexMut<Range<usize>> for String
[src]
impl IndexMut<RangeFrom<usize>> for String
[src]
impl IndexMut<RangeFull> for String
[src]
impl IndexMut<RangeFull> for OsString
[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 R
impl<'_, R> Read for &'_ mut R where
R: Read + ?Sized, impl<'_, W> Write for &'_ mut W where
W: Write + ?Sized, 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;
[src]
Notable traits for &'_ mut R
impl<'_, R> Read for &'_ mut R where
R: Read + ?Sized, impl<'_, W> Write for &'_ mut W where
W: Write + ?Sized, 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<J> IndexMut<J> for IxDynImpl where
[usize]: IndexMut<J>,
[src]
[usize]: IndexMut<J>,
impl<S, D, I> IndexMut<I> for ArrayBase<S, D> where
D: Dimension,
I: NdIndex<D>,
S: DataMut,
[src]
D: Dimension,
I: NdIndex<D>,
S: DataMut,
Access the element at index mutably.
Panics if index is out of bounds.
impl<T, I> IndexMut<I> for Vec<T> where
I: SliceIndex<[T]>,
[src]
I: SliceIndex<[T]>,