pub struct SliceCopy<'a, V = ()>where
V: ?Sized,{ /* private fields */ }
Implementations§
source§impl<'a, V> SliceCopy<'a, V>
impl<'a, V> SliceCopy<'a, V>
sourcepub fn from_slice<T: CopyElem>(slice: &[T]) -> Selfwhere
V: VTable<T>,
pub fn from_slice<T: CopyElem>(slice: &[T]) -> Selfwhere
V: VTable<T>,
Construct a SliceCopy
from a given typed slice by reusing the provided memory.
source§impl<'a, V: ?Sized> SliceCopy<'a, V>
impl<'a, V: ?Sized> SliceCopy<'a, V>
sourcepub fn into_raw_parts(
self
) -> (&'a [MaybeUninit<u8>], ElemInfo, VTableRef<'a, V>)
pub fn into_raw_parts( self ) -> (&'a [MaybeUninit<u8>], ElemInfo, VTableRef<'a, V>)
Convert this collection into its raw components.
This function exists mainly to enable the into_dyn
macro until CoerceUnsized
is
stabilized.
Safety
Calling this function is not inherently unsafe, but using the returned values incorrectly may cause undefined behaviour.
sourcepub unsafe fn from_raw_parts(
data: &'a [MaybeUninit<u8>],
elem: ElemInfo,
vtable: impl Into<VTableRef<'a, V>>
) -> Self
pub unsafe fn from_raw_parts( data: &'a [MaybeUninit<u8>], elem: ElemInfo, vtable: impl Into<VTableRef<'a, V>> ) -> Self
Construct a SliceCopy
from raw bytes and type metadata.
Almost exclusively the only inputs that work here are the ones returned by
into_raw_parts
.
Safety
This function should not be used other than in internal APIs. It exists to enable the
into_dyn
macro until CoerceUsize
is stabilized.
sourcepub fn upcast<U: From<V>>(self) -> SliceCopy<'a, U>where
V: Clone,
pub fn upcast<U: From<V>>(self) -> SliceCopy<'a, U>where
V: Clone,
Upcast the SliceCopy
into a more general base SliceCopy
.
This function converts the underlying virtual function table into a subset of the existing
sourcepub fn check<T: Any>(&self) -> Option<&Self>
pub fn check<T: Any>(&self) -> Option<&Self>
Check if the current buffer contains elements of the specified type.
Returns Some(self)
if the type matches and None
otherwise.
sourcepub fn reborrow(&self) -> SliceCopy<'_, V>
pub fn reborrow(&self) -> SliceCopy<'_, V>
Construct a clone of the current slice with a reduced lifetime.
This is equivalent to calling subslice
with the entire range.
sourcepub fn element_type_id(&self) -> TypeId
pub fn element_type_id(&self) -> TypeId
Get the TypeId
of data stored within this buffer.
sourcepub fn element_size(&self) -> usize
pub fn element_size(&self) -> usize
Get the size of the element type in bytes.
sourcepub fn iter_as<T: Any>(&self) -> Option<Iter<'_, T>>
pub fn iter_as<T: Any>(&self) -> Option<Iter<'_, T>>
Return an iterator to a slice representing typed data.
Returs None
if the given type T
doesn’t match the internal.
Examples
use dync::SliceCopy;
let vec = vec![1.0_f32, 23.0, 0.01, 42.0, 11.43];
let buf = SliceCopy::<()>::from_slice(vec.as_slice());
for (i, &val) in buf.iter_as::<f32>().unwrap().enumerate() {
assert_eq!(val, vec[i]);
}
sourcepub fn append_copy_to_vec<'b, T: CopyElem>(
&self,
vec: &'b mut Vec<T>
) -> Option<&'b mut Vec<T>>
pub fn append_copy_to_vec<'b, T: CopyElem>( &self, vec: &'b mut Vec<T> ) -> Option<&'b mut Vec<T>>
Append copied items from this buffer to a given Vec<T>
. Return the mutable reference
Some(vec)
if type matched the internal type and None
otherwise.
sourcepub fn copy_into_vec<T: CopyElem>(&self) -> Option<Vec<T>>
pub fn copy_into_vec<T: CopyElem>(&self) -> Option<Vec<T>>
Copies contents of self
into the given Vec
.
sourcepub fn as_slice<T: Any>(&self) -> Option<&[T]>
pub fn as_slice<T: Any>(&self) -> Option<&[T]>
Borrow this slice as a typed slice.
Returns None
if the given type T
doesn’t match the internal.
sourcepub fn iter(&self) -> impl Iterator<Item = CopyValueRef<'_, V>>
pub fn iter(&self) -> impl Iterator<Item = CopyValueRef<'_, V>>
Return an iterator over untyped value references stored in this buffer.
In contrast to iter
, this function defers downcasting on a per element basis.
As a result, this type of iteration is typically less efficient if a typed value is needed
for each element.
Examples
use dync::SliceCopy;
let vec = vec![1.0_f32, 23.0, 0.01, 42.0, 11.43];
let buf: SliceCopy = SliceCopy::from(vec.as_slice());
for (i, val) in buf.iter().enumerate() {
assert_eq!(val.downcast::<f32>().unwrap(), &vec[i]);
}
pub fn into_iter(self) -> impl Iterator<Item = CopyValueRef<'a, V>>where
V: Clone,
pub fn chunks_exact( &self, chunk_size: usize ) -> impl Iterator<Item = SliceCopy<'_, V>>
pub fn split_at(&self, mid: usize) -> (SliceCopy<'_, V>, SliceCopy<'_, V>)
sourcepub fn get(&self, i: usize) -> CopyValueRef<'_, V>
pub fn get(&self, i: usize) -> CopyValueRef<'_, V>
Get a immutable value reference to the element at index i
.
sourcepub fn subslice<I>(&self, i: I) -> SliceCopy<'_, V>
pub fn subslice<I>(&self, i: I) -> SliceCopy<'_, V>
Get an immutable subslice representing the given range of indices.
sourcepub fn into_subslice<I>(self, i: I) -> SliceCopy<'a, V>
pub fn into_subslice<I>(self, i: I) -> SliceCopy<'a, V>
Conver this slice into a mutable subslice representing the given range of indices.
Trait Implementations§
source§impl<'b, 'a: 'b, V: ?Sized> From<&'b SliceCopyMut<'a, V>> for SliceCopy<'b, V>
impl<'b, 'a: 'b, V: ?Sized> From<&'b SliceCopyMut<'a, V>> for SliceCopy<'b, V>
source§fn from(s: &'b SliceCopyMut<'a, V>) -> SliceCopy<'b, V>
fn from(s: &'b SliceCopyMut<'a, V>) -> SliceCopy<'b, V>
Auto Trait Implementations§
impl<'a, V: ?Sized> RefUnwindSafe for SliceCopy<'a, V>where
V: RefUnwindSafe,
impl<'a, V: ?Sized> Send for SliceCopy<'a, V>
impl<'a, V: ?Sized> Sync for SliceCopy<'a, V>where
V: Sync,
impl<'a, V: ?Sized> Unpin for SliceCopy<'a, V>
impl<'a, V: ?Sized> UnwindSafe for SliceCopy<'a, V>where
V: UnwindSafe + RefUnwindSafe,
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
source§impl<T> CloneBytes for Twhere
T: Clone + 'static,
impl<T> CloneBytes for Twhere
T: Clone + 'static,
unsafe fn clone_bytes(src: &[MaybeUninit<u8>]) -> Box<[MaybeUninit<u8>]>
unsafe fn clone_from_bytes(dst: &mut [MaybeUninit<u8>], src: &[MaybeUninit<u8>])
unsafe fn clone_into_raw_bytes( src: &[MaybeUninit<u8>], dst: &mut [MaybeUninit<u8>] )
source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.