pub trait Index<Idx>where
Idx: ?Sized,{
type Output: ?Sized;
// Required method
fn index(&self, index: Idx) -> &Self::Output;
}Expand description
Used for indexing operations (container[index]) in immutable contexts.
container[index] is actually syntactic sugar for *container.index(index),
but only when used as an immutable value. If a mutable value is requested,
IndexMut is used instead. This allows nice things such as
let value = v[index] if the type of value implements Copy.
§Examples
The following example implements Index on a read-only NucleotideCount
container, enabling individual counts to be retrieved with index syntax.
use std::ops::Index;
enum Nucleotide {
A,
C,
G,
T,
}
struct NucleotideCount {
a: usize,
c: usize,
g: usize,
t: usize,
}
impl Index<Nucleotide> for NucleotideCount {
type Output = usize;
fn index(&self, nucleotide: Nucleotide) -> &Self::Output {
match nucleotide {
Nucleotide::A => &self.a,
Nucleotide::C => &self.c,
Nucleotide::G => &self.g,
Nucleotide::T => &self.t,
}
}
}
let nucleotide_count = NucleotideCount {a: 14, c: 9, g: 10, t: 12};
assert_eq!(nucleotide_count[Nucleotide::A], 14);
assert_eq!(nucleotide_count[Nucleotide::C], 9);
assert_eq!(nucleotide_count[Nucleotide::G], 10);
assert_eq!(nucleotide_count[Nucleotide::T], 12);Required Associated Types§
Required Methods§
Implementors§
§impl Index<SpecialCodeIndex> for SpecialCodes
impl Index<SpecialCodeIndex> for SpecialCodes
§impl Index<RangeInclusive<usize>> for ArchivedString
impl Index<RangeInclusive<usize>> for ArchivedString
§impl Index<RangeToInclusive<usize>> for ArchivedString
impl Index<RangeToInclusive<usize>> for ArchivedString
§impl<'bump> Index<RangeInclusive<usize>> for devela::_dep::bumpalo::collections::String<'bump>
impl<'bump> Index<RangeInclusive<usize>> for devela::_dep::bumpalo::collections::String<'bump>
§impl<'bump> Index<RangeToInclusive<usize>> for devela::_dep::bumpalo::collections::String<'bump>
impl<'bump> Index<RangeToInclusive<usize>> for devela::_dep::bumpalo::collections::String<'bump>
§impl<'bump, T, I> Index<I> for devela::_dep::bumpalo::collections::Vec<'bump, T>where
I: SliceIndex<[T]>,
impl<'bump, T, I> Index<I> for devela::_dep::bumpalo::collections::Vec<'bump, T>where
I: SliceIndex<[T]>,
type Output = <I as SliceIndex<[T]>>::Output
§impl<'h> Index<usize> for Captures<'h>
Get a matching capture group’s haystack substring by index.
impl<'h> Index<usize> for Captures<'h>
Get a matching capture group’s haystack substring by index.
The haystack substring returned can’t outlive the Captures object if this
method is used, because of how Index is defined (normally a[i] is part
of a and can’t outlive it). To work around this limitation, do that, use
Captures::get instead.
'h is the lifetime of the matched haystack, but the lifetime of the
&str returned by this implementation is the lifetime of the Captures
value itself.
§Panics
If there is no matching group at the given index.
§impl<'h, 'n> Index<&'n str> for Captures<'h>
Get a matching capture group’s haystack substring by name.
impl<'h, 'n> Index<&'n str> for Captures<'h>
Get a matching capture group’s haystack substring by name.
The haystack substring returned can’t outlive the Captures object if this
method is used, because of how Index is defined (normally a[i] is part
of a and can’t outlive it). To work around this limitation, do that, use
Captures::get instead.
'h is the lifetime of the matched haystack, but the lifetime of the
&str returned by this implementation is the lifetime of the Captures
value itself.
'n is the lifetime of the group name used to index the Captures value.
§Panics
If there is no matching group at the given name.
§impl<A, I> Index<I> for SmallVec<A>where
A: Array,
I: SliceIndex<[<A as Array>::Item]>,
impl<A, I> Index<I> for SmallVec<A>where
A: Array,
I: SliceIndex<[<A as Array>::Item]>,
type Output = <I as SliceIndex<[<A as Array>::Item]>>::Output
§impl<I> Index<I> for Bound<'_, PyBytes>where
I: SliceIndex<[u8]>,
This is the same way Vec is indexed.
impl<I> Index<I> for Bound<'_, PyBytes>where
I: SliceIndex<[u8]>,
This is the same way Vec is indexed.