Enum ps_datachunk::DataChunk

pub enum DataChunk<'lt> {
    Aligned(AlignedDataChunk),
    Borrowed(BorrowedDataChunk<'lt>),
    Mbuf(MbufDataChunk<'lt>),
    Owned(OwnedDataChunk),
    Shared(SharedDataChunk),
}

represents a chunk of data that is either owned or pointed to

Variants

Aligned(AlignedDataChunk)

Borrowed(BorrowedDataChunk<'lt>)

Mbuf(MbufDataChunk<'lt>)

Owned(OwnedDataChunk)

Shared(SharedDataChunk)

Implementations

impl<'lt> DataChunk<'lt>

pub fn try_from<const S: usize, T: Archive + Serialize<AllocSerializer<S>>>( value: &T, ) -> Result<Self>

pub fn try_as<T: Archive>(&'lt self) -> Result<&'lt T::Archived>

where <T as Archive>::Archived: CheckBytes<DefaultValidator<'lt>>,

pub fn align(&self) -> Cow<'_, AlignedDataChunk>

impl<'lt> DataChunk<'lt>

pub fn data_ref(&self) -> &[u8]

pub fn hash_ref(&self) -> &[u8]

pub fn hash(&self) -> HashCow<'_>

pub fn into_owned(self) -> OwnedDataChunk

Unwraps this DataChunk into an OwnedDataChunk.

• DataChunk::Borrowed() allocates a new OwnedDataChunk, recalculates hash
• DataChunk::Mbuf() allocates a new OwnedDataChunk, recalculates hash
• DataChunk::Aligned() indirectly invokes the OwnedDataChunk deserializer
• DataChunk::Owned() is a no-op

pub fn to_owned(&self) -> OwnedDataChunk

Gets an owned copy of this DataChunk.

pub fn serialize_into(self) -> Vec<u8>

convert this DataChunk into a Vec<u8>

• DataChunk::Mbuf() is copied via .to_owned()

pub fn serialize(&self) -> Vec<u8>

Serializes this DataChunk into a new Vec<u8>.

pub fn decrypt( &self, key: &[u8], compressor: &Compressor, ) -> Result<OwnedDataChunk>

Decrypts this DataChunk with a given key.

pub fn encrypt(&self, compressor: &Compressor) -> Result<EncryptedDataChunk>

Encrypts this DataChunk.

pub fn encrypt_mut( &mut self, compressor: &Compressor, ) -> Result<EncryptedDataChunk>

Encrypts this DataChunk using self.data if owned.

pub fn guarantee_alignment<T>(self) -> DataChunk<'lt>

Trait Implementations

impl<'lt> DataChunkTrait for DataChunk<'lt>

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

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

fn hash(&self) -> HashCow<'_>

fn encrypt(&self, compressor: &Compressor) -> Result<EncryptedDataChunk>

fn decrypt(&self, key: &[u8], compressor: &Compressor) -> Result<OwnedDataChunk>

fn to_datachunk(&self) -> DataChunk<'_>

fn align(&self) -> AlignedDataChunk

fn borrow(&self) -> BorrowedDataChunk<'_>

fn to_owned(&self) -> OwnedDataChunk

fn try_as<T: Archive>(&self) -> Result<TypedDataChunk<'_, T>>

where T::Archived: for<'a> CheckBytes<DefaultValidator<'a>>,

impl<'lt> From<&Arc<[u8]>> for DataChunk<'lt>

fn from(data: &Arc<[u8]>) -> Self

Converts to this type from the input type.

impl<'lt> From<&DataChunk<'lt>> for AlignedDataChunk

fn from(value: &DataChunk<'_>) -> Self

Converts to this type from the input type.

impl<'lt> From<AlignedDataChunk> for DataChunk<'lt>

fn from(chunk: AlignedDataChunk) -> Self

Converts to this type from the input type.

impl<'lt> From<Arc<[u8]>> for DataChunk<'lt>

fn from(data: Arc<[u8]>) -> Self

Converts to this type from the input type.

impl<'lt> From<BorrowedDataChunk<'lt>> for DataChunk<'lt>

fn from(chunk: BorrowedDataChunk<'lt>) -> Self

Converts to this type from the input type.

impl<'lt> From<DataChunk<'lt>> for AlignedDataChunk

fn from(value: DataChunk<'_>) -> Self

Converts to this type from the input type.

impl<'lt> From<DataChunk<'lt>> for OwnedDataChunk

fn from(value: DataChunk<'lt>) -> Self

Converts to this type from the input type.

impl<'lt> From<MbufDataChunk<'lt>> for DataChunk<'lt>

fn from(chunk: MbufDataChunk<'lt>) -> Self

Converts to this type from the input type.

impl<'lt> From<OwnedDataChunk> for DataChunk<'lt>

fn from(chunk: OwnedDataChunk) -> Self

Converts to this type from the input type.

impl<'lt, T> TryFrom<DataChunk<'lt>> for TypedDataChunk<'lt, T>

where T: Archive, T::Archived: for<'a> CheckBytes<DefaultValidator<'a>>,

type Error = PsDataChunkError

The type returned in the event of a conversion error.

fn try_from(chunk: DataChunk<'lt>) -> Result<TypedDataChunk<'lt, T>>

Performs the conversion.