Struct sodoken::BufWriteSized

pub struct BufWriteSized<const N: usize>(pub Arc<dyn AsBufWriteSized<N>>);

A concrete sized writable buffer type that may or may not be mem_locked.

Tuple Fields

0: Arc<dyn AsBufWriteSized<N>>

Implementations

impl<const N: usize> BufWriteSized<N>

pub fn new_no_lock() -> Self

Consruct a new BufWrite that is NOT mem_locked.

pub fn new_mem_locked() -> SodokenResult<Self>

Construct a new BufWrite that IS mem_locked. Use this for passwords / private keys, etc, but NOT everything, locked memory is a finite resource.

pub fn deep_clone_no_lock<O>(o: O) -> Self where
    O: Into<BufReadSized<N>> + 'static + Send, 

Deep clone the data referred to by another buffer object, into a new non-memory-locked BufWrite instance.

pub fn deep_clone_mem_locked<O>(o: O) -> SodokenResult<Self> where
    O: Into<BufReadSized<N>> + 'static + Send, 

Deep clone the data referred to by another buffer object, into a new MEMORY LOCKED BufWrite instance.

pub fn len(&self) -> usize

The length of this buffer.

pub fn is_empty(&self) -> bool

Is this buffer empty?

pub fn read_lock(&self) -> ReadGuard<'_>

Obtain read access to the underlying buffer.

pub fn read_lock_sized(&self) -> ReadGuardSized<'_, N>

Obtain read access to the underlying buffer.

pub fn to_read_unsized(&self) -> BufRead

Convert to an unsized BufRead instance without cloning internal data and without changing memory locking strategy.

pub fn write_lock(&self) -> WriteGuard<'_>

Obtain write access to the underlying buffer.

pub fn to_read(&self) -> BufRead

Downgrade this to a read-only reference without cloning internal data and without changing memory locking strategy.

pub fn write_lock_sized(&self) -> WriteGuardSized<'_, N>

Obtain write access to the underlying buffer.

pub fn to_read_sized(&self) -> BufReadSized<N>

Downgrade this to a read-only reference without cloning internal data and without changing memory locking strategy.

pub fn to_write_unsized(&self) -> BufWrite

Convert to an unsized BufWrite instance without cloning internal data and without changing memory locking strategy.

pub fn to_extend(&self) -> BufExtend

Transform this buffer into an extendable type.

pub fn try_unwrap(self) -> Result<Box<[u8]>, BufRead>

Attempt to extract the inner contents of this buf without cloning. If this memory is locked or there are clones of this reference, the unwrap will fail, returning a BufRead instance.

pub fn try_unwrap_sized(self) -> Result<[u8; N], BufReadSized<N>>

Attempt to extract the inner contents of this buf without cloning. If this memory is locked or there are clones of this reference, the unwrap will fail, returning a BufRead instance.

Trait Implementations

impl<const N: usize> Clone for BufWriteSized<N>

fn clone(&self) -> BufWriteSized<N>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const N: usize> Debug for BufWriteSized<N>

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

Formats the value using the given formatter.

impl<const N: usize> From<[u8; N]> for BufWriteSized<N>

fn from(b: [u8; N]) -> Self

Performs the conversion.

impl<const N: usize> From<BufWriteSized<N>> for BufExtend

fn from(b: BufWriteSized<N>) -> Self

Performs the conversion.

impl<const S: usize> From<BufWriteSized<S>> for BufRead

fn from(b: BufWriteSized<S>) -> Self

Performs the conversion.

impl<const S: usize> From<BufWriteSized<S>> for BufReadSized<S>

fn from(b: BufWriteSized<S>) -> Self

Performs the conversion.

impl<const S: usize> From<BufWriteSized<S>> for BufWrite

fn from(b: BufWriteSized<S>) -> Self

Performs the conversion.