pub struct EntityStaticRange<I: EntityId, const N: usize> { /* private fields */ }Expand description
A range of IDs materialized at compile-time.
The purpose of this type is to support indexing with the [_] operator, whether rustc likes it
or not. Internally, this is done by preparing an array which lists all the IDs in the range, so
that we may freely return references to it.
Implementations§
Source§impl<T: EntityTag, const N: usize> EntityStaticRange<EntityIdU8<T>, N>
impl<T: EntityTag, const N: usize> EntityStaticRange<EntityIdU8<T>, N>
Source§impl<T: EntityTag, const N: usize> EntityStaticRange<EntityIdU16<T>, N>
impl<T: EntityTag, const N: usize> EntityStaticRange<EntityIdU16<T>, N>
Source§impl<T: EntityTag, const N: usize> EntityStaticRange<EntityIdU32<T>, N>
impl<T: EntityTag, const N: usize> EntityStaticRange<EntityIdU32<T>, N>
Source§impl<I: EntityId, const N: usize> EntityStaticRange<I, N>
impl<I: EntityId, const N: usize> EntityStaticRange<I, N>
Sourcepub const fn index_const(&self, idx: usize) -> I
pub const fn index_const(&self, idx: usize) -> I
Returns self[idx], but available in a const context.
Sourcepub fn index_of(&self, id: I) -> Option<usize>
pub fn index_of(&self, id: I) -> Option<usize>
Return the position of id in this range, if present.
This is done in O(1) time, without scanning through the materialized array.
pub fn contains(&self, id: I) -> bool
Methods from Deref<Target = [I; N]>§
1.57.0 · Sourcepub fn as_slice(&self) -> &[T]
pub fn as_slice(&self) -> &[T]
Returns a slice containing the entire array. Equivalent to &s[..].
1.77.0 · Sourcepub fn each_ref(&self) -> [&T; N]
pub fn each_ref(&self) -> [&T; N]
Borrows each element and returns an array of references with the same
size as self.
§Example
let floats = [3.1, 2.7, -1.0];
let float_refs: [&f64; 3] = floats.each_ref();
assert_eq!(float_refs, [&3.1, &2.7, &-1.0]);This method is particularly useful if combined with other methods, like
map. This way, you can avoid moving the original
array if its elements are not Copy.
let strings = ["Ferris".to_string(), "♥".to_string(), "Rust".to_string()];
let is_ascii = strings.each_ref().map(|s| s.is_ascii());
assert_eq!(is_ascii, [true, false, true]);
// We can still access the original array: it has not been moved.
assert_eq!(strings.len(), 3);Sourcepub fn split_array_ref<const M: usize>(&self) -> (&[T; M], &[T])
🔬This is a nightly-only experimental API. (split_array)
pub fn split_array_ref<const M: usize>(&self) -> (&[T; M], &[T])
split_array)Divides one array reference into two at an index.
The first will contain all indices from [0, M) (excluding
the index M itself) and the second will contain all
indices from [M, N) (excluding the index N itself).
§Panics
Panics if M > N.
§Examples
#![feature(split_array)]
let v = [1, 2, 3, 4, 5, 6];
{
let (left, right) = v.split_array_ref::<0>();
assert_eq!(left, &[]);
assert_eq!(right, &[1, 2, 3, 4, 5, 6]);
}
{
let (left, right) = v.split_array_ref::<2>();
assert_eq!(left, &[1, 2]);
assert_eq!(right, &[3, 4, 5, 6]);
}
{
let (left, right) = v.split_array_ref::<6>();
assert_eq!(left, &[1, 2, 3, 4, 5, 6]);
assert_eq!(right, &[]);
}Sourcepub fn rsplit_array_ref<const M: usize>(&self) -> (&[T], &[T; M])
🔬This is a nightly-only experimental API. (split_array)
pub fn rsplit_array_ref<const M: usize>(&self) -> (&[T], &[T; M])
split_array)Divides one array reference into two at an index from the end.
The first will contain all indices from [0, N - M) (excluding
the index N - M itself) and the second will contain all
indices from [N - M, N) (excluding the index N itself).
§Panics
Panics if M > N.
§Examples
#![feature(split_array)]
let v = [1, 2, 3, 4, 5, 6];
{
let (left, right) = v.rsplit_array_ref::<0>();
assert_eq!(left, &[1, 2, 3, 4, 5, 6]);
assert_eq!(right, &[]);
}
{
let (left, right) = v.rsplit_array_ref::<2>();
assert_eq!(left, &[1, 2, 3, 4]);
assert_eq!(right, &[5, 6]);
}
{
let (left, right) = v.rsplit_array_ref::<6>();
assert_eq!(left, &[]);
assert_eq!(right, &[1, 2, 3, 4, 5, 6]);
}