Trait BufferMut 

pub unsafe trait BufferMut<S: ?Sized>: Buffer<S> {
    // Required methods
    fn as_mut_slice(&mut self) -> &mut S;
    fn capacity(&self) -> usize;
    unsafe fn set_len(&mut self, len: usize) -> bool;
    fn try_reserve(&mut self, additional: usize) -> Result<(), TryReserveError>;
}

A buffer that contains a mutable slice.

The buffer may be resizable, and the whole slice may have an uninitialized section.

Safety

• as_mut_slice must return the same slice as Buffer::as_slice
• The full buffer slice must have at least capacity maybe uninitialized items; as_mut_slice returns in fact the beginning of the full slice.
• Accessing capacity must not invalidate the buffer slice.
• If set_len returns true, then the length of as_mut_slice must have been updated accordingly.
• If try_reserve returns successfully, then capacity must have been increased by at least additional items.
• If the buffer implements BorrowMetadata, then borrow_metadata must not invalidate the buffer slice.

Required Methods

fn as_mut_slice(&mut self) -> &mut S

Returns the mutable buffer slice.

fn capacity(&self) -> usize

Returns the buffer capacity.

unsafe fn set_len(&mut self, len: usize) -> bool

Set the length of the buffer slice.

Returns false if this operation is not supported, for example for fixed size buffers like AsMutBuffer.

Safety

First len items of buffer slice must be initialized.

fn try_reserve(&mut self, additional: usize) -> Result<(), TryReserveError>

Tries reserving capacity for at least additional items.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl BufferMut<str> for String

fn as_mut_slice(&mut self) -> &mut str

fn capacity(&self) -> usize

unsafe fn set_len(&mut self, len: usize) -> bool

fn try_reserve(&mut self, additional: usize) -> Result<(), TryReserveError>

impl BufferMut<BStr> for BString

Available on crate feature bstr only.

fn as_mut_slice(&mut self) -> &mut BStr

fn capacity(&self) -> usize

unsafe fn set_len(&mut self, len: usize) -> bool

fn try_reserve(&mut self, additional: usize) -> Result<(), TryReserveError>

impl<T: Send + Sync + 'static> BufferMut<[T]> for Vec<T>

fn as_mut_slice(&mut self) -> &mut [T]

fn capacity(&self) -> usize

unsafe fn set_len(&mut self, len: usize) -> bool

fn try_reserve(&mut self, additional: usize) -> Result<(), TryReserveError>

Implementors

impl<S: Slice + ?Sized, B: AsRef<S> + AsMut<S> + Send + Sync + 'static> BufferMut<S> for AsMutBuffer<B>

SAFETY: Trait contract is upheld by AsMutBuffer::new contract.