Struct flatcontainer::impls::slice::SliceRegion
source · pub struct SliceRegion<C: Region, O: OffsetContainer<C::Index> = Vec<<C as Region>::Index>> { /* private fields */ }
Expand description
A container representing slices of data.
Reading from this region is more involved than for others, because the data only exists in
an indexable representation. The read item is a ReadSlice
, which can be iterated or indexed.
However, it is not possible to represent the data as a slice, simply because the slice doesn’t
exist.
§Examples
We fill some data into a slice region and use the ReadSlice
to extract it later.
use flatcontainer::{Containerized, CopyOnto, Region, SliceRegion};
let mut r = <SliceRegion<<String as Containerized>::Region>>::default();
let panagram_en = "The quick fox jumps over the lazy dog"
.split(" ")
.collect::<Vec<_>>();
let panagram_de = "Zwölf Boxkämpfer jagen Viktor quer über den großen Sylter Deich"
.split(" ")
.collect::<Vec<_>>();
let en_index = (&panagram_en).copy_onto(&mut r);
let de_index = (&panagram_de).copy_onto(&mut r);
assert!(panagram_de.into_iter().eq(r.index(de_index)));
assert!(panagram_en.into_iter().eq(r.index(en_index)));
assert_eq!(r.index(de_index).get(2), "jagen");
Trait Implementations§
source§impl<C: Clone + Region, O: Clone + OffsetContainer<C::Index>> Clone for SliceRegion<C, O>
impl<C: Clone + Region, O: Clone + OffsetContainer<C::Index>> Clone for SliceRegion<C, O>
source§fn clone(&self) -> SliceRegion<C, O>
fn clone(&self) -> SliceRegion<C, O>
Returns a copy of the value. Read more
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moresource§impl<'a, C, T: 'a, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for &'a [T]
impl<'a, C, T: 'a, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for &'a [T]
source§fn copy_onto(
self,
target: &mut SliceRegion<C, O>
) -> <SliceRegion<C, O> as Region>::Index
fn copy_onto( self, target: &mut SliceRegion<C, O> ) -> <SliceRegion<C, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.
source§impl<'a, C, T, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for &'a Vec<T>
impl<'a, C, T, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for &'a Vec<T>
source§fn copy_onto(
self,
target: &mut SliceRegion<C, O>
) -> <SliceRegion<C, O> as Region>::Index
fn copy_onto( self, target: &mut SliceRegion<C, O> ) -> <SliceRegion<C, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.
source§impl<'a, C: Region + 'a, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for ReadSlice<'a, C, O>
impl<'a, C: Region + 'a, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for ReadSlice<'a, C, O>
source§fn copy_onto(
self,
target: &mut SliceRegion<C, O>
) -> <SliceRegion<C, O> as Region>::Index
fn copy_onto( self, target: &mut SliceRegion<C, O> ) -> <SliceRegion<C, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.
source§impl<C, T, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for Vec<T>
impl<C, T, O: OffsetContainer<C::Index>> CopyOnto<SliceRegion<C, O>> for Vec<T>
source§fn copy_onto(
self,
target: &mut SliceRegion<C, O>
) -> <SliceRegion<C, O> as Region>::Index
fn copy_onto( self, target: &mut SliceRegion<C, O> ) -> <SliceRegion<C, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.
source§impl<'a, T, R: Region, O: OffsetContainer<R::Index>, const N: usize> CopyOnto<SliceRegion<R, O>> for &'a [T; N]
impl<'a, T, R: Region, O: OffsetContainer<R::Index>, const N: usize> CopyOnto<SliceRegion<R, O>> for &'a [T; N]
source§fn copy_onto(
self,
target: &mut SliceRegion<R, O>
) -> <SliceRegion<R, O> as Region>::Index
fn copy_onto( self, target: &mut SliceRegion<R, O> ) -> <SliceRegion<R, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.
source§impl<T, R: Region, O: OffsetContainer<R::Index>, const N: usize> CopyOnto<SliceRegion<R, O>> for [T; N]
impl<T, R: Region, O: OffsetContainer<R::Index>, const N: usize> CopyOnto<SliceRegion<R, O>> for [T; N]
source§fn copy_onto(
self,
target: &mut SliceRegion<R, O>
) -> <SliceRegion<R, O> as Region>::Index
fn copy_onto( self, target: &mut SliceRegion<R, O> ) -> <SliceRegion<R, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.
source§impl<C: Debug + Region, O: Debug + OffsetContainer<C::Index>> Debug for SliceRegion<C, O>
impl<C: Debug + Region, O: Debug + OffsetContainer<C::Index>> Debug for SliceRegion<C, O>
source§impl<C: Region, O: OffsetContainer<C::Index>> Default for SliceRegion<C, O>
impl<C: Region, O: OffsetContainer<C::Index>> Default for SliceRegion<C, O>
source§impl<'de, C, O> Deserialize<'de> for SliceRegion<C, O>
impl<'de, C, O> Deserialize<'de> for SliceRegion<C, O>
source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
source§impl<C: Region, O: OffsetContainer<C::Index>> Region for SliceRegion<C, O>
impl<C: Region, O: OffsetContainer<C::Index>> Region for SliceRegion<C, O>
§type ReadItem<'a> = ReadSlice<'a, C, O>
where
Self: 'a
type ReadItem<'a> = ReadSlice<'a, C, O> where Self: 'a
The type of the data that one gets out of the container.
§type Index = (usize, usize)
type Index = (usize, usize)
The type to index into the container. Should be treated
as an opaque type, even if known.
source§fn merge_regions<'a>(regions: impl Iterator<Item = &'a Self> + Clone) -> Selfwhere
Self: 'a,
fn merge_regions<'a>(regions: impl Iterator<Item = &'a Self> + Clone) -> Selfwhere
Self: 'a,
Construct a region that can absorb the contents of
regions
in the future.source§fn index(&self, (start, end): Self::Index) -> Self::ReadItem<'_>
fn index(&self, (start, end): Self::Index) -> Self::ReadItem<'_>
Index into the container. The index must be obtained by
pushing data into the container.
source§fn reserve_regions<'a, I>(&mut self, regions: I)
fn reserve_regions<'a, I>(&mut self, regions: I)
Ensure that the region can absorb the items of
regions
without reallocationsource§impl<'a, T, R: Region, O: OffsetContainer<R::Index>> ReserveItems<SliceRegion<R, O>> for &'a [T]where
&'a T: ReserveItems<R> + 'a,
impl<'a, T, R: Region, O: OffsetContainer<R::Index>> ReserveItems<SliceRegion<R, O>> for &'a [T]where
&'a T: ReserveItems<R> + 'a,
source§fn reserve_items<I>(target: &mut SliceRegion<R, O>, items: I)
fn reserve_items<I>(target: &mut SliceRegion<R, O>, items: I)
Ensure that the region can absorb
items
without reallocation.source§impl<'a, T: 'a, R: Region, O: OffsetContainer<R::Index>, const N: usize> ReserveItems<SliceRegion<R, O>> for &'a [T; N]where
&'a T: ReserveItems<R>,
impl<'a, T: 'a, R: Region, O: OffsetContainer<R::Index>, const N: usize> ReserveItems<SliceRegion<R, O>> for &'a [T; N]where
&'a T: ReserveItems<R>,
source§fn reserve_items<I>(target: &mut SliceRegion<R, O>, items: I)
fn reserve_items<I>(target: &mut SliceRegion<R, O>, items: I)
Ensure that the region can absorb
items
without reallocation.source§impl<'a, T: 'a, R: Region, O: OffsetContainer<R::Index>> ReserveItems<SliceRegion<R, O>> for &'a Vec<T>where
&'a T: ReserveItems<R>,
impl<'a, T: 'a, R: Region, O: OffsetContainer<R::Index>> ReserveItems<SliceRegion<R, O>> for &'a Vec<T>where
&'a T: ReserveItems<R>,
source§fn reserve_items<I>(target: &mut SliceRegion<R, O>, items: I)
fn reserve_items<I>(target: &mut SliceRegion<R, O>, items: I)
Ensure that the region can absorb
items
without reallocation.Auto Trait Implementations§
impl<C, O> Freeze for SliceRegion<C, O>
impl<C, O> RefUnwindSafe for SliceRegion<C, O>where
O: RefUnwindSafe,
C: RefUnwindSafe,
impl<C, O> Send for SliceRegion<C, O>
impl<C, O> Sync for SliceRegion<C, O>
impl<C, O> Unpin for SliceRegion<C, O>
impl<C, O> UnwindSafe for SliceRegion<C, O>where
O: UnwindSafe,
C: UnwindSafe,
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<R, O, T> CopyOnto<ConsecutiveOffsetPairs<R, O>> for T
impl<R, O, T> CopyOnto<ConsecutiveOffsetPairs<R, O>> for T
source§fn copy_onto(
self,
target: &mut ConsecutiveOffsetPairs<R, O>
) -> <ConsecutiveOffsetPairs<R, O> as Region>::Index
fn copy_onto( self, target: &mut ConsecutiveOffsetPairs<R, O> ) -> <ConsecutiveOffsetPairs<R, O> as Region>::Index
Copy self into the target container, returning an index that allows to
look up the corresponding read item.