Trait IndexMut

pub trait IndexMut<Idx>: Index<Idx>
where
    Idx: ?Sized,
{
    // Required method
    fn index_mut(&mut self, index: Idx) -> &mut Self::Output;
}

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

Re-exported from core::ops:: .

---

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 {index:?}-side of balance immutably");
        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 {index:?}-side of balance mutably");
        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.

Panics

May panic if the index is out of bounds.

Implementors

impl IndexMut<usize> for ByteStr

impl IndexMut<usize> for ByteString

impl IndexMut<usize> for Vec3A

impl IndexMut<usize> for Vec4

impl IndexMut<usize> for Vec2

impl IndexMut<usize> for Vec3

impl IndexMut<usize> for DVec2

impl IndexMut<usize> for DVec3

impl IndexMut<usize> for DVec4

impl IndexMut<usize> for I8Vec2

impl IndexMut<usize> for I8Vec3

impl IndexMut<usize> for I8Vec4

impl IndexMut<usize> for I16Vec2

impl IndexMut<usize> for I16Vec3

impl IndexMut<usize> for I16Vec4

impl IndexMut<usize> for IVec2

impl IndexMut<usize> for IVec3

impl IndexMut<usize> for IVec4

impl IndexMut<usize> for I64Vec2

impl IndexMut<usize> for I64Vec3

impl IndexMut<usize> for I64Vec4

impl IndexMut<usize> for U8Vec2

impl IndexMut<usize> for U8Vec3

impl IndexMut<usize> for U8Vec4

impl IndexMut<usize> for U16Vec2

impl IndexMut<usize> for U16Vec3

impl IndexMut<usize> for U16Vec4

impl IndexMut<usize> for UVec2

impl IndexMut<usize> for UVec3

impl IndexMut<usize> for UVec4

impl IndexMut<usize> for U64Vec2

impl IndexMut<usize> for U64Vec3

impl IndexMut<usize> for U64Vec4

impl IndexMut<usize> for fiat_25519_loose_field_element

impl IndexMut<usize> for fiat_25519_loose_field_element

impl IndexMut<usize> for fiat_25519_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_25519_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_25519_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_25519_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_25519_tight_field_element

impl IndexMut<usize> for fiat_25519_tight_field_element

impl IndexMut<usize> for fiat_p224_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p224_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p224_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p224_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p256_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p384_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p434_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p434_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_p448_loose_field_element

impl IndexMut<usize> for fiat_p448_loose_field_element

impl IndexMut<usize> for fiat_p448_tight_field_element

impl IndexMut<usize> for fiat_p448_tight_field_element

impl IndexMut<usize> for fiat_p521_loose_field_element

impl IndexMut<usize> for fiat_p521_loose_field_element

impl IndexMut<usize> for fiat_p521_tight_field_element

impl IndexMut<usize> for fiat_p521_tight_field_element

impl IndexMut<usize> for fiat_poly1305_loose_field_element

impl IndexMut<usize> for fiat_poly1305_loose_field_element

impl IndexMut<usize> for fiat_poly1305_tight_field_element

impl IndexMut<usize> for fiat_poly1305_tight_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_scalar_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_scalar_non_montgomery_domain_field_element

impl IndexMut<usize> for fiat_secp256k1_montgomery_scalar_non_montgomery_domain_field_element

impl IndexMut<SpecialCodeIndex> for SpecialCodes

impl IndexMut<Range<usize>> for ByteStr

impl IndexMut<Range<usize>> for ByteString

impl IndexMut<Range<usize>> for UninitSlice

impl IndexMut<RangeFrom<usize>> for ByteStr

impl IndexMut<RangeFrom<usize>> for ByteString

impl IndexMut<RangeFrom<usize>> for UninitSlice

impl IndexMut<RangeFull> for ByteStr

impl IndexMut<RangeFull> for ByteString

impl IndexMut<RangeFull> for OsString

impl IndexMut<RangeFull> for UninitSlice

impl IndexMut<RangeInclusive<usize>> for ByteStr

impl IndexMut<RangeInclusive<usize>> for ByteString

impl IndexMut<RangeInclusive<usize>> for UninitSlice

impl IndexMut<RangeTo<usize>> for ByteStr

impl IndexMut<RangeTo<usize>> for ByteString

impl IndexMut<RangeTo<usize>> for UninitSlice

impl IndexMut<RangeToInclusive<usize>> for ByteStr

impl IndexMut<RangeToInclusive<usize>> for ByteString

impl IndexMut<RangeToInclusive<usize>> for UninitSlice

impl<'a, T> IndexMut<usize> for CSliceMut<'a, T>

impl<'a, V> IndexMut<&'a usize> for VecMap<V>

impl<'bump> IndexMut<Range<usize>> for devela::_dep::bumpalo::collections::String<'bump>

impl<'bump> IndexMut<RangeFrom<usize>> for devela::_dep::bumpalo::collections::String<'bump>

impl<'bump> IndexMut<RangeFull> for devela::_dep::bumpalo::collections::String<'bump>

impl<'bump> IndexMut<RangeInclusive<usize>> for devela::_dep::bumpalo::collections::String<'bump>

impl<'bump> IndexMut<RangeTo<usize>> for devela::_dep::bumpalo::collections::String<'bump>

impl<'bump> IndexMut<RangeToInclusive<usize>> for devela::_dep::bumpalo::collections::String<'bump>

impl<'bump, T, I> IndexMut<I> for devela::_dep::bumpalo::collections::Vec<'bump, T>

where I: SliceIndex<[T]>,

impl<'s> IndexMut<&'s str> for DocumentMut

impl<'s> IndexMut<&'s str> for InlineTable

impl<'s> IndexMut<&'s str> for Table

impl<A, I> IndexMut<I> for SmallVec<A>

where A: Array, I: SliceIndex<[<A as Array>::Item]>,

impl<Buffer> IndexMut<(u8, u32, u32)> for FlatSamples<Buffer>

where Buffer: IndexMut<usize>,

impl<I> IndexMut<I> for Item

where I: Index,

impl<I> IndexMut<I> for str

where I: SliceIndex<str>,

impl<I> IndexMut<I> for devela::all::String

where I: SliceIndex<str>,

impl<I, T, const N: usize> IndexMut<I> for Simd<T, N>

where T: SimdElement, LaneCount<N>: SupportedLaneCount, I: SliceIndex<[T]>,

impl<K, V> IndexMut<(Bound<usize>, Bound<usize>)> for Slice<K, V>

impl<K, V> IndexMut<usize> for Slice<K, V>

impl<K, V> IndexMut<Range<usize>> for Slice<K, V>

impl<K, V> IndexMut<RangeFrom<usize>> for Slice<K, V>

impl<K, V> IndexMut<RangeFull> for Slice<K, V>

impl<K, V> IndexMut<RangeInclusive<usize>> for Slice<K, V>

impl<K, V> IndexMut<RangeTo<usize>> for Slice<K, V>

impl<K, V> IndexMut<RangeToInclusive<usize>> for Slice<K, V>

impl<K, V, Q, S> IndexMut<&Q> for IndexMap<K, V, S>

where Q: Hash + Equivalent<K> + ?Sized, S: BuildHasher,

Access [IndexMap] values corresponding to a key.

Mutable indexing allows changing / updating values of key-value pairs that are already present.

You can not insert new pairs with index syntax, use .insert().

Examples

use indexmap::IndexMap;

let mut map = IndexMap::new();
for word in "Lorem ipsum dolor sit amet".split_whitespace() {
    map.insert(word.to_lowercase(), word.to_string());
}
let lorem = &mut map["lorem"];
assert_eq!(lorem, "Lorem");
lorem.retain(char::is_lowercase);
assert_eq!(map["lorem"], "orem");

use indexmap::IndexMap;

let mut map = IndexMap::new();
map.insert("foo", 1);
map["bar"] = 1; // panics!

impl<K, V, S> IndexMut<(Bound<usize>, Bound<usize>)> for IndexMap<K, V, S>

impl<K, V, S> IndexMut<usize> for IndexMap<K, V, S>

Access [IndexMap] values at indexed positions.

Mutable indexing allows changing / updating indexed values that are already present.

You can not insert new values with index syntax – use [.insert()][IndexMap::insert].

Examples

use indexmap::IndexMap;

let mut map = IndexMap::new();
for word in "Lorem ipsum dolor sit amet".split_whitespace() {
    map.insert(word.to_lowercase(), word.to_string());
}
let lorem = &mut map[0];
assert_eq!(lorem, "Lorem");
lorem.retain(char::is_lowercase);
assert_eq!(map["lorem"], "orem");

use indexmap::IndexMap;

let mut map = IndexMap::new();
map.insert("foo", 1);
map[10] = 1; // panics!

impl<K, V, S> IndexMut<Range<usize>> for IndexMap<K, V, S>

impl<K, V, S> IndexMut<RangeFrom<usize>> for IndexMap<K, V, S>

impl<K, V, S> IndexMut<RangeFull> for IndexMap<K, V, S>

impl<K, V, S> IndexMut<RangeInclusive<usize>> for IndexMap<K, V, S>

impl<K, V, S> IndexMut<RangeTo<usize>> for IndexMap<K, V, S>

impl<K, V, S> IndexMut<RangeToInclusive<usize>> for IndexMap<K, V, S>

impl<P, Container> IndexMut<(u32, u32)> for ImageBuffer<P, Container>

where P: Pixel, Container: Deref<Target = [<P as Pixel>::Subpixel]> + DerefMut,

impl<T> IndexMut<usize> for Luma<T>

impl<T> IndexMut<usize> for LumaA<T>

impl<T> IndexMut<usize> for Rgb<T>

impl<T> IndexMut<usize> for Rgba<T>

impl<T> IndexMut<usize> for CVec<T>

impl<T> IndexMut<Key> for Arena<T>

impl<T, A> IndexMut<usize> for VecDeque<T, A>

where A: Allocator,

impl<T, I> IndexMut<I> for [T]

where I: SliceIndex<[T]>,

impl<T, I, A> IndexMut<I> for devela::all::Vec<T, A>

where I: SliceIndex<[T]>, A: Allocator,

impl<T, I, const N: usize> IndexMut<I> for [T; N]

where [T]: IndexMut<I>,

impl<V> IndexMut<usize> for VecMap<V>