Struct BufferViewMut 

pub struct BufferViewMut { /* private fields */ }

A write-only view of a mapped buffer’s bytes.

To get a BufferViewMut, first map the buffer, and then call buffer.slice(range).get_mapped_range_mut().

Because Rust has no write-only reference type (&[u8] is read-only and &mut [u8] is read-write), this type does not dereference to a slice in the way that BufferView does. Instead, .slice() returns a special WriteOnly pointer type, and there are also a few convenience methods such as BufferViewMut::copy_from_slice().

Before the buffer can be unmapped, all BufferViewMuts observing it must be dropped. Otherwise, the call to Buffer::unmap will panic.

For example code, see the documentation on mapping buffers.

Implementations

impl BufferViewMut

These methods are equivalent to the methods of the same names on WriteOnly.

pub fn len(&self) -> usize

Returns the length of this view; the number of bytes to be written.

pub fn is_empty(&self) -> bool

Returns true if the view has a length of 0.

Note that this is currently impossible.

pub fn slice<'a, S>(&'a mut self, bounds: S) -> WriteOnly<'a, [u8]>

where S: RangeBounds<usize>,

Returns a WriteOnly reference to a portion of this.

.slice(..) can be used to access the whole data.

pub fn copy_from_slice(&mut self, src: &[u8])

Copies all elements from src into self.

The length of src must be the same as self.

This method is equivalent to self.slice(..).copy_from_slice(src).

Trait Implementations

impl Debug for BufferViewMut

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

Formats the value using the given formatter.

impl Drop for BufferViewMut

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.