Struct ViewMutData 

pub struct ViewMutData<'a, T> { /* private fields */ }

Storage for a mutable tensor view.

This has the same representation in memory as a mutable slice: a pointer and a length. Unlike a slice it allows for other storage objects to reference memory ranges that overlap with this one. It is up to APIs built on top of this to ensure uniqueness of mutable references.

Implementations

impl<'a, T> ViewMutData<'a, T>

pub unsafe fn to_slice_mut(self) -> &'a mut [T]

Variant of StorageMut::as_slice_mut which preserves the underlying lifetime in the result.

Safety

See StorageMut::as_slice_mut.

pub fn split_mut( self, left: Range<usize>, right: Range<usize>, ) -> (ViewMutData<'a, T>, ViewMutData<'a, T>)

Split the storage into two sub-views.

Unlike splitting a slice, this does not ensure that the two halves do not overlap, only that the “left” and “right” ranges are valid.

pub unsafe fn to_view_slice_mut( &mut self, range: Range<usize>, ) -> ViewMutData<'a, T>

A variant of StorageMut::slice_mut which preserves the lifetime of the slice.

Safety

This is unsafe since this function cannot ensure that multiple references to the same element are not created (by using get_mut on self and the slice). It is up to the caller to prevent this.

Trait Implementations

impl<'a, T> AssumeInit for ViewMutData<'a, MaybeUninit<T>>

type Output = ViewMutData<'a, T>

The type of the initialized storage.

unsafe fn assume_init(self) -> Self::Output

Cast self to a collection of initialized values.

impl<'a, T: Debug> Debug for ViewMutData<'a, T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> Storage for ViewMutData<'_, T>

const MUTABLE: bool = true

True if this storage allows mutable access via StorageMut. This is used to determine if a layout can be safely used with a storage. Layouts where multiple indices map to the same offset must not be used with mutable storage.

type Elem = T

The element type.

fn len(&self) -> usize

Return the number of elements in the storage.

fn as_ptr(&self) -> *const T

Return a pointer to the first element in the storage.

fn is_empty(&self) -> bool

Return true if the storage contains no elements.

unsafe fn get(&self, offset: usize) -> Option<&Self::Elem>

Return the element at a given offset, or None if offset >= self.len().

unsafe fn get_unchecked(&self, offset: usize) -> &Self::Elem

Return a reference to the element at offset.

fn slice(&self, range: Range<usize>) -> ViewData<'_, Self::Elem>

Return a view of a sub-region of the storage.

fn view(&self) -> ViewData<'_, Self::Elem>

Return an immutable view of this storage.

unsafe fn as_slice(&self) -> &[Self::Elem]

Return the contents of the storage as a slice.

impl<T> StorageMut for ViewMutData<'_, T>

fn as_mut_ptr(&mut self) -> *mut T

Return a mutable pointer to the first element in storage.

unsafe fn get_mut(&mut self, offset: usize) -> Option<&mut Self::Elem>

Mutable version of Storage::get.

unsafe fn get_unchecked_mut(&mut self, offset: usize) -> &mut Self::Elem

Mutable version of Storage::get_unchecked.

fn slice_mut(&mut self, range: Range<usize>) -> ViewMutData<'_, Self::Elem>

Return a slice of this storage.

fn view_mut(&mut self) -> ViewMutData<'_, Self::Elem>

Return a mutable view of this storage.

unsafe fn as_slice_mut(&mut self) -> &mut [Self::Elem]

Return the stored elements as a mutable slice.

impl<T> Send for ViewMutData<'_, T>