Struct dryoc::protected::HeapByteArray

pub struct HeapByteArray<const LENGTH: usize>(_);

This is supported on crate feature nightly only.

A heap-allocated fixed-length byte array, using the page-aligned allocator. Required for working with protected memory regions. Wraps a Vec with custom Allocator implementation.

Trait Implementations

impl<const LENGTH: usize> AsMut<[u8; LENGTH]> for HeapByteArray<LENGTH>

fn as_mut(&mut self) -> &mut [u8; LENGTH]

Performs the conversion.

impl<const LENGTH: usize> AsMut<[u8]> for HeapByteArray<LENGTH>

fn as_mut(&mut self) -> &mut [u8]

Performs the conversion.

impl<const LENGTH: usize> AsRef<[u8; LENGTH]> for HeapByteArray<LENGTH>

fn as_ref(&self) -> &[u8; LENGTH]

Performs the conversion.

impl<const LENGTH: usize> AsRef<[u8]> for HeapByteArray<LENGTH>

fn as_ref(&self) -> &[u8]

Performs the conversion.

impl<const LENGTH: usize> ByteArray<LENGTH> for HeapByteArray<LENGTH>

fn as_array(&self) -> &[u8; LENGTH]

Returns a reference to the underlying fixed-length byte array.

impl<const LENGTH: usize> Bytes for HeapByteArray<LENGTH>

fn as_slice(&self) -> &[u8]

Returns a slice of the underlying bytes.

fn len(&self) -> usize

Shorthand to retrieve the underlying length of the byte array.

fn is_empty(&self) -> bool

Returns true if the array is empty.

impl<const LENGTH: usize> Clone for HeapByteArray<LENGTH>

fn clone(&self) -> HeapByteArray<LENGTH>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const LENGTH: usize> Debug for HeapByteArray<LENGTH>

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

Formats the value using the given formatter.

impl<const LENGTH: usize> Default for HeapByteArray<LENGTH>

fn default() -> Self

Returns the “default value” for a type.

impl<const LENGTH: usize> Deref for HeapByteArray<LENGTH>

type Target = [u8]

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<const LENGTH: usize> DerefMut for HeapByteArray<LENGTH>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<const LENGTH: usize> Drop for HeapByteArray<LENGTH>

fn drop(&mut self)

Executes the destructor for this type.

impl<const LENGTH: usize> From<&'_ [u8; LENGTH]> for HeapByteArray<LENGTH>

fn from(src: &[u8; LENGTH]) -> Self

Performs the conversion.

impl<const LENGTH: usize> From<[u8; LENGTH]> for HeapByteArray<LENGTH>

fn from(src: [u8; LENGTH]) -> Self

Performs the conversion.

impl<const LENGTH: usize> From<StackByteArray<LENGTH>> for HeapByteArray<LENGTH>

fn from(other: StackByteArray<LENGTH>) -> Self

Performs the conversion.

impl<const LENGTH: usize> Index<Range<usize>> for HeapByteArray<LENGTH>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: Range<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> Index<RangeFrom<usize>> for HeapByteArray<LENGTH>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeFrom<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> Index<RangeFull> for HeapByteArray<LENGTH>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeFull) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> Index<RangeInclusive<usize>> for HeapByteArray<LENGTH>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeInclusive<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> Index<RangeTo<usize>> for HeapByteArray<LENGTH>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeTo<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> Index<RangeToInclusive<usize>> for HeapByteArray<LENGTH>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeToInclusive<usize>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> Index<usize> for HeapByteArray<LENGTH>

type Output = u8

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<Range<usize>> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: Range<usize>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<RangeFrom<usize>> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: RangeFrom<usize>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<RangeFull> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: RangeFull) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<RangeInclusive<usize>> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: RangeInclusive<usize>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<RangeTo<usize>> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: RangeTo<usize>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<RangeToInclusive<usize>> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: RangeToInclusive<usize>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> IndexMut<usize> for HeapByteArray<LENGTH>

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<const LENGTH: usize> Lockable<HeapByteArray<LENGTH>> for HeapByteArray<LENGTH>

fn mlock(
    self
) -> Result<Protected<HeapByteArray<LENGTH>, ReadWrite, Locked>, Error>

Locks a HeapByteArray, and returns a Protected wrapper.

impl<const LENGTH: usize> MutByteArray<LENGTH> for HeapByteArray<LENGTH>

fn as_mut_array(&mut self) -> &mut [u8; LENGTH]

Returns a mutable reference to the underlying fixed-length byte array.

impl<const LENGTH: usize> MutBytes for HeapByteArray<LENGTH>

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

Returns a mutable slice to the underlying bytes.

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

Copies into the underlying slice from other. Panics if lengths do not match.

impl<const LENGTH: usize> NewByteArray<LENGTH> for HeapByteArray<LENGTH>

fn gen() -> Self

Returns a new byte array filled with random data.

fn new_byte_array() -> Self

Returns a new fixed-length byte array, initialized with zeroes.

impl<const LENGTH: usize> NewBytes for HeapByteArray<LENGTH>

fn new_bytes() -> Self

Returns an empty, unallocated, arbitrary-length byte array.

impl<const LENGTH: usize> NewLockedFromSlice<HeapByteArray<LENGTH>> for HeapByteArray<LENGTH>

fn from_slice_into_locked(
    other: &[u8]
) -> Result<Protected<Self, ReadWrite, Locked>, Error>

Returns a new locked byte array from other. Panics if sizes do not match.

fn from_slice_into_readonly_locked(
    other: &[u8]
) -> Result<Protected<Self, ReadOnly, Locked>, Error>

Returns a new read-only locked region of memory from src.

impl<const LENGTH: usize> PartialEq<HeapByteArray<LENGTH>> for HeapByteArray<LENGTH>

fn eq(&self, other: &HeapByteArray<LENGTH>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &HeapByteArray<LENGTH>) -> bool

This method tests for !=.

impl<const LENGTH: usize> Serialize for HeapByteArray<LENGTH>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

impl<const LENGTH: usize> TryFrom<&'_ [u8]> for HeapByteArray<LENGTH>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(src: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl<const LENGTH: usize> Zeroize for HeapByteArray<LENGTH>

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl<const LENGTH: usize> StructuralPartialEq for HeapByteArray<LENGTH>